client

type AssignMode struct {
	ZT bool `json:"zt"`
}

type Client interface {
	// Status 获取节点状态
	Status(ctx context.Context) (*NodeStatus, error)
	// Networks 网络管理
	Networks() NetworkService
	// Peers 节点管理
	Peers() PeerService
	// Controller 控制器管理（自托管时可用）
	Controller() ControllerService
}

type ControllerMember struct {
	ID                   string   `json:"id"`
	Address              string   `json:"address"`
	NetworkID            string   `json:"networkId"`
	Authorized           bool     `json:"authorized"`
	ActiveBridge         bool     `json:"activeBridge"`
	IPAssignments        []string `json:"ipAssignments"`
	NoAutoAssignIPs      bool     `json:"noAutoAssignIps"`
	Revision             int      `json:"revision"`
	CreationTime         int64    `json:"creationTime"`
	LastAuthorizedTime   int64    `json:"lastAuthorizedTime"`
	LastDeauthorizedTime int64    `json:"lastDeauthorizedTime"`
}

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

type ControllerMemberConfig struct {
	Authorized      *bool    `json:"authorized,omitempty"`
	ActiveBridge    *bool    `json:"activeBridge,omitempty"`
	IPAssignments   []string `json:"ipAssignments,omitempty"`
	NoAutoAssignIPs *bool    `json:"noAutoAssignIps,omitempty"`
}

type ControllerNetwork struct {
	ID                string             `json:"id"`
	Name              string             `json:"name"`
	Private           bool               `json:"private"`
	CreationTime      int64              `json:"creationTime"`
	Revision          int                `json:"revision"`
	MulticastLimit    int                `json:"multicastLimit"`
	EnableBroadcast   bool               `json:"enableBroadcast"`
	Routes            []Route            `json:"routes"`
	IPAssignmentPools []IPAssignmentPool `json:"ipAssignmentPools"`
	V4AssignMode      *AssignMode        `json:"v4AssignMode,omitempty"`
	V6AssignMode      *AssignMode        `json:"v6AssignMode,omitempty"`
}

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

type ControllerNetworkConfig struct {
	Name              string             `json:"name,omitempty"`
	Private           *bool              `json:"private,omitempty"`
	EnableBroadcast   *bool              `json:"enableBroadcast,omitempty"`
	MulticastLimit    *int               `json:"multicastLimit,omitempty"`
	Routes            []Route            `json:"routes,omitempty"`
	IPAssignmentPools []IPAssignmentPool `json:"ipAssignmentPools,omitempty"`
	V4AssignMode      *AssignMode        `json:"v4AssignMode,omitempty"`
	V6AssignMode      *AssignMode        `json:"v6AssignMode,omitempty"`
}

type ControllerService interface {
	// Status 获取控制器状态
	Status(ctx context.Context) (*ControllerStatus, error)
	// ListNetworks 列出控制器管理的所有网络
	ListNetworks(ctx context.Context) ([]string, error)
	// GetNetwork 获取网络配置
	GetNetwork(ctx context.Context, networkID string) (*ControllerNetwork, error)
	// CreateNetwork 创建新网络
	CreateNetwork(ctx context.Context, nodeID string, config *ControllerNetworkConfig) (*ControllerNetwork, error)
	// UpdateNetwork 更新网络配置
	UpdateNetwork(ctx context.Context, networkID string, config *ControllerNetworkConfig) (*ControllerNetwork, error)
	// DeleteNetwork 删除网络
	DeleteNetwork(ctx context.Context, networkID string) error
	// ListMembers 列出网络成员
	ListMembers(ctx context.Context, networkID string) ([]string, error)
	// GetMember 获取成员信息
	GetMember(ctx context.Context, networkID, memberID string) (*ControllerMember, error)
	// UpdateMember 更新成员配置
	UpdateMember(ctx context.Context, networkID, memberID string, config *ControllerMemberConfig) (*ControllerMember, error)
	// DeleteMember 删除成员
	DeleteMember(ctx context.Context, networkID, memberID string) error
}

type ControllerStatus struct {
	Controller bool  `json:"controller"`
	APIVersion int   `json:"apiVersion"`
	Clock      int64 `json:"clock"`
}

type DNS struct {
	Domain  string   `json:"domain"`
	Servers []string `json:"servers,omitempty"`
}

type IPAssignmentPool struct {
	IPRangeStart string `json:"ipRangeStart"`
	IPRangeEnd   string `json:"ipRangeEnd"`
}

type Network struct {
	ID                string   `json:"id"`
	Name              string   `json:"name"`
	Status            string   `json:"status"`
	Type              string   `json:"type"`
	MAC               string   `json:"mac"`
	MTU               int      `json:"mtu"`
	Bridge            bool     `json:"bridge"`
	BroadcastEnabled  bool     `json:"broadcastEnabled"`
	PortDeviceName    string   `json:"portDeviceName"`
	NetconfRevision   int      `json:"netconfRevision"`
	AssignedAddresses []string `json:"assignedAddresses"`
	AllowDNS          bool     `json:"allowDNS"`
	AllowDefault      bool     `json:"allowDefault"`
	AllowGlobal       bool     `json:"allowGlobal"`
	AllowManaged      bool     `json:"allowManaged"`
	DNS               *DNS     `json:"dns,omitempty"`
}

type NetworkService interface {
	// List 列出所有已加入的网络
	List(ctx context.Context) ([]Network, error)
	// Get 获取指定网络详情
	Get(ctx context.Context, networkID string) (*Network, error)
	// Join 加入网络
	Join(ctx context.Context, networkID string) (*Network, error)
	// Leave 离开网络
	Leave(ctx context.Context, networkID string) error
	// Update 更新网络设置
	Update(ctx context.Context, networkID string, settings *NetworkSettings) (*Network, error)
}

type NetworkSettings struct {
	AllowDNS     *bool `json:"allowDNS,omitempty"`
	AllowDefault *bool `json:"allowDefault,omitempty"`
	AllowGlobal  *bool `json:"allowGlobal,omitempty"`
	AllowManaged *bool `json:"allowManaged,omitempty"`
}

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

type NodeStatus struct {
	Address           string `json:"address"`
	Clock             int64  `json:"clock"`
	Online            bool   `json:"online"`
	PlanetWorldID     int64  `json:"planetWorldId"`
	PublicIdentity    string `json:"publicIdentity"`
	TCPFallbackActive bool   `json:"tcpFallbackActive"`
	Version           string `json:"version"`
}

type Option func(*client)

type Peer struct {
	Address string     `json:"address"`
	Version string     `json:"version"`
	Role    string     `json:"role"`
	Latency int        `json:"latency"`
	Paths   []PeerPath `json:"paths"`
}

type PeerPath struct {
	Active        bool   `json:"active"`
	Address       string `json:"address"`
	Expired       bool   `json:"expired"`
	LastReceive   int64  `json:"lastReceive"`
	LastSend      int64  `json:"lastSend"`
	Preferred     bool   `json:"preferred"`
	TrustedPathID int64  `json:"trustedPathId"`
}

type PeerService interface {
	// List 列出所有 Peers
	List(ctx context.Context) ([]Peer, error)
	// Get 获取指定 Peer 信息
	Get(ctx context.Context, peerID string) (*Peer, error)
}

type Route struct {
	Target string  `json:"target"`
	Via    *string `json:"via,omitempty"`
}