extensions

type CheckoutInput struct {
	Invoice    InvoiceInfo `json:"invoice"`
	Customer   Customer    `json:"customer"`
	ReturnURL  string      `json:"return_url"`
	CancelURL  string      `json:"cancel_url"`
	WebhookURL string      `json:"webhook_url"`
}

type CheckoutOutput struct {
	RedirectURL string `json:"redirect_url"`
}

type Customer struct {
	Email string `json:"email"`
	Name  string `json:"name"`
}

type Gateway struct {
	Name       string   `json:"name"`       // shown on the pay button
	Currencies []string `json:"currencies"` // empty = any
}

type HTTPRequest struct {
	Method  string            `json:"method"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    string            `json:"body,omitempty"`
}

type HTTPResponse struct {
	Status  int               `json:"status"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    string            `json:"body"`
	Error   string            `json:"error,omitempty"`
}

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

type HostOptions struct {
	Logger *slog.Logger
	KV     KV
	// AllowPrivateNetworks lets plugin HTTP reach private/loopback addresses (tests only).
	AllowPrivateNetworks bool
}

type InvoiceInfo struct {
	ID       string `json:"id"`
	Number   string `json:"number"`
	Total    int64  `json:"total"`
	Currency string `json:"currency"`
}

type KV interface {
	Get(ctx context.Context, ext, key string) ([]byte, bool, error)
	Set(ctx context.Context, ext, key string, value []byte) error
}

type Manifest struct {
	ID          string      `json:"id"`
	Name        string      `json:"name"`
	Version     string      `json:"version"`
	API         string      `json:"api"` // semver range of the core API, e.g. "^1.0"
	Description string      `json:"description,omitempty"`
	Author      string      `json:"author,omitempty"`
	Homepage    string      `json:"homepage,omitempty"`
	Backend     string      `json:"backend,omitempty"`  // path of the .wasm in the package
	Frontend    string      `json:"frontend,omitempty"` // path of the ES module in the package
	Permissions Permissions `json:"permissions"`
	Settings    []Setting   `json:"settings,omitempty"`
	Gateway     *Gateway    `json:"gateway,omitempty"` // set when the extension is a payment gateway
	// Provisioner is set when the extension delivers products on another system (a
	// Pterodactyl or Pelican panel, Proxmox, ...).
	Provisioner *Provisioner `json:"provisioner,omitempty"`
}

type Package struct {
	Manifest Manifest
	Files    map[string][]byte // every file except the signature
	Signer   string            // base64 public key of a valid signature, "" if unsigned
}

type Permissions struct {
	// HTTP lists hosts the plugin may call: exact, "*.example.com", or "setting:<key>" for
	// the host of a URL the admin enters in that setting (e.g. a self-hosted panel).
	HTTP   []string `json:"http,omitempty"`
	Events []string `json:"events,omitempty"` // core events delivered to on_event
	KV     bool     `json:"kv,omitempty"`     // a small key/value store
}

type ProvisionInput struct {
	Subscription ProvisionSubscription `json:"subscription"`
	User         ProvisionUser         `json:"user"`
	Product      ProvisionProduct      `json:"product"`
	// ExternalID is what provision_create returned (empty for create).
	ExternalID string `json:"external_id"`
}

type ProvisionOutput struct {
	ExternalID string `json:"external_id"`
	// Info is shown to the customer: a link to manage it, and a few details.
	Info struct {
		URL     string            `json:"url,omitempty"`
		Details map[string]string `json:"details,omitempty"`
	} `json:"info"`
}

type ProvisionProduct struct {
	ID       string            `json:"id"`
	Name     string            `json:"name"`
	Settings map[string]string `json:"settings"`
}

type ProvisionSubscription struct {
	ID         string `json:"id"`
	Name       string `json:"name"`
	Cycle      string `json:"cycle"`
	MemoryMB   int    `json:"memory_mb"`
	CPUPercent int    `json:"cpu_percent"`
	DiskMB     int    `json:"disk_mb"`
}

type ProvisionUser struct {
	ID    string `json:"id"`
	Email string `json:"email"`
	Name  string `json:"name"`
}

type Provisioner struct {
	Name     string    `json:"name"`
	Settings []Setting `json:"settings,omitempty"`
}

type Setting struct {
	Key      string `json:"key"`
	Label    string `json:"label"`
	Type     string `json:"type"` // text | secret | boolean
	Required bool   `json:"required,omitempty"`
	Help     string `json:"help,omitempty"`
}

type Version struct{ Major, Minor, Patch int }

type WebhookInput struct {
	Method  string              `json:"method"`
	Headers map[string][]string `json:"headers"`
	Query   map[string][]string `json:"query"`
	Body    string              `json:"body"`
}

type WebhookOutput struct {
	Status    string `json:"status"`
	InvoiceID string `json:"invoice_id"`
	Ref       string `json:"ref"`
	Amount    int64  `json:"amount"`
	Currency  string `json:"currency"`
	// RedirectURL continues a browser flow (GET) on a page of the panel.
	RedirectURL string `json:"redirect_url,omitempty"`
}