deploy

type APIError struct {
	Status   int
	Code     string
	Message  string
	LoginURL string
}

type AuthInfo struct {
	Mode        string      `json:"mode"`
	CLILoginURL string      `json:"cli_login_url,omitempty"`
	Device      *DeviceInfo `json:"device,omitempty"`
	// AnonymousDeploy is true when deploys need no token (auth.mode=none + allow_anonymous).
	AnonymousDeploy bool `json:"anonymous_deploy"`
}

type Client struct {
	BaseURL   string // gateway base URL G
	Token     string // bearer token ("" for anonymous)
	HTTP      *http.Client
	UserAgent string
}

type CommitRequest struct {
	Files []FileEntry `json:"files"`
}

type CommitResponse struct {
	Site    sites.Meta `json:"site"`
	URL     string     `json:"url"`
	Deleted int        `json:"deleted"`
}

type CreateDeployRequest struct {
	Files   []FileEntry `json:"files"`
	Message string      `json:"message,omitempty"`
}

type CreateDeployResponse struct {
	DeployID  string    `json:"deploy_id"`
	Uploads   []Upload  `json:"uploads"`
	Unchanged []string  `json:"unchanged"`
	ExpiresAt time.Time `json:"expires_at"`
}

type DeployOptions struct {
	Ignore      []string // extra gitignore-style patterns
	Message     string
	Concurrency int // parallel uploads (default 8)
	DryRun      bool
	// Progress receives progress events. Calls are serialized, so the
	// callback need not be safe for concurrent use.
	Progress func(ProgressEvent)
}

type DeployResult struct {
	Site      sites.Meta
	URL       string
	Uploaded  int
	Unchanged int
	Deleted   int
	Bytes     int64
	Files     []LocalFile // the collected files (also filled for DryRun)
}

type DeviceInfo struct {
	Issuer   string   `json:"issuer"`
	ClientID string   `json:"client_id"`
	Scopes   []string `json:"scopes"`
}

type ErrorBody struct {
	Error struct {
		Code     string `json:"code"`
		Message  string `json:"message"`
		LoginURL string `json:"login_url,omitempty"`
	} `json:"error"`
}

type FileEntry struct {
	Path        string `json:"path"`
	Size        int64  `json:"size"`
	SHA256      string `json:"sha256"`
	ContentType string `json:"content_type,omitempty"`
}

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

type GatewayOptions struct {
	Config   *config.Config
	Store    blob.Store
	Registry *sites.Registry
	// Auth authenticates requests (the server's Authenticator when embedded,
	// auth.NewBearer for the standalone gateway / Lambda).
	Auth auth.Authenticator
	// BaseURL is the absolute URL the gateway is reachable at (used to build
	// self-hosted upload URLs and Info.GatewayURL), e.g.
	// https://backyard.acme.com/__backyard/api/deploy
	BaseURL string
	// OnDeleteSite is called after a site is deleted (e.g. to drop its
	// database documents). Optional.
	OnDeleteSite func(ctx context.Context, site string) error
	Logger       *slog.Logger
	// Version reported in Info.
	Version string
	// MCPURL is the remote MCP endpoint of the hub this gateway is embedded
	// in (SPEC §14.1), reported as Info.MCPURL; "" omits it.
	MCPURL string
}

type Info struct {
	Name        string            `json:"name"`
	Version     string            `json:"version"`
	PublicURL   string            `json:"public_url"`
	BaseDomain  string            `json:"base_domain"`
	URLMode     string            `json:"url_mode"`
	GatewayURL  string            `json:"gateway_url"`
	Auth        AuthInfo          `json:"auth"`
	Storage     *blob.Description `json:"storage,omitempty"`
	Methods     []string          `json:"methods"`
	RsyncTarget string            `json:"rsync_target,omitempty"`
	Limits      Limits            `json:"limits"`
	// MCPURL is the hub's remote MCP endpoint (SPEC §7.1, §14.1): present
	// while the Claude connector is enabled, on the hub's embedded gateway
	// only.
	MCPURL string `json:"mcp_url,omitempty"`
}

type Limits struct {
	MaxSiteBytes int64 `json:"max_site_bytes"`
	MaxFiles     int   `json:"max_files"`
	MaxFileBytes int64 `json:"max_file_bytes"`
}

type LocalFile struct {
	Path        string // site-relative, "/"-separated
	Abs         string // absolute path on disk
	Size        int64
	SHA256      string // hex
	ContentType string
}

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

type OwnersRequest struct {
	Add    []string `json:"add,omitempty"`
	Remove []string `json:"remove,omitempty"`
}

type ProgressEvent struct {
	Phase string // "scan" | "plan" | "upload" | "commit" | "done"
	Path  string
	Done  int
	Total int
	Bytes int64
}

type PublishError struct {
	ID, Message string
	RetryAfter  time.Duration
}

type PublishFile struct {
	Path        string
	Data        []byte
	ContentType string
}

type PublishRequest struct {
	User      *identity.User
	Site      string
	Files     []PublishFile
	Delete    []string
	Replace   bool
	Overwrite bool
	// ClientIP, ClientName and GrantID go into the deploy.commit audit record.
	ClientIP, ClientName, GrantID string
}

type PublishResult struct {
	Site, URL                           string
	Created                             bool
	Files, Uploaded, Unchanged, Deleted int
	Bytes                               int64
	Warnings                            []string
}

type SiteFile struct {
	Path      string    `json:"path"`
	Size      int64     `json:"size"`
	SHA256    string    `json:"sha256,omitempty"`
	UpdatedAt time.Time `json:"updated_at"`
}

type Upload struct {
	Path    string            `json:"path"`
	URL     string            `json:"url"`
	Method  string            `json:"method"`
	Headers map[string]string `json:"headers,omitempty"`
}