andy
c98ace2396
New protocol type 'github' for browsing repositories via the GitHub REST API. Creates a non-terminal panel showing repos grouped by owner/org, sorted by last commit date (newest first), with search filtering and auto-refresh. Backend: - ProtocolGitHub constant and GitHubConfig/GitHubRepo model structs - New internal/githubclient package (REST API, pagination, token validation) - Session manager connectGitHub() with periodic refresh goroutine - API surface: RefreshGitHubRepos() for on-demand refresh - Token stored via existing credential infrastructure (keychain/vault) Frontend: - GitHub tab in profile editor with API URL and token storage fields - New github.js viewer component (grouped repos, badges, language dots) - github.css with charcoal-themed repo cards and org headers - Protocol colour tokens, tab badge, sidebar indicator for GitHub - Event wiring for session:github:repos and session:github:error - Cleanup on tab close Supports GitHub Enterprise via configurable API base URL.
230 lines
8.1 KiB
Go
230 lines
8.1 KiB
Go
// Package models defines the core data structures used throughout
|
|
// the Nexus Terminal application.
|
|
package models
|
|
|
|
import "time"
|
|
|
|
// Protocol represents the connection protocol for a session.
|
|
type Protocol string
|
|
|
|
const (
|
|
ProtocolSSH Protocol = "ssh"
|
|
ProtocolTelnet Protocol = "telnet"
|
|
ProtocolRAW Protocol = "raw"
|
|
ProtocolGitHub Protocol = "github"
|
|
)
|
|
|
|
// HostKeyPolicy determines how unknown or changed SSH host keys are handled.
|
|
type HostKeyPolicy string
|
|
|
|
const (
|
|
HostKeyStrict HostKeyPolicy = "strict"
|
|
HostKeyAsk HostKeyPolicy = "ask"
|
|
HostKeyAcceptNew HostKeyPolicy = "accept-new"
|
|
HostKeyInsecure HostKeyPolicy = "insecure"
|
|
)
|
|
|
|
// SecretMode controls how credentials are persisted.
|
|
type SecretMode string
|
|
|
|
const (
|
|
SecretModeSaved SecretMode = "saved"
|
|
SecretModeSessionOnly SecretMode = "session-only"
|
|
SecretModeAskEveryTime SecretMode = "ask-every-time"
|
|
)
|
|
|
|
// LineEnding specifies the line-ending convention for Telnet and RAW connections.
|
|
type LineEnding string
|
|
|
|
const (
|
|
LineEndingLF LineEnding = "lf"
|
|
LineEndingCR LineEnding = "cr"
|
|
LineEndingCRLF LineEnding = "crlf"
|
|
LineEndingNone LineEnding = "none"
|
|
)
|
|
|
|
// Profile holds the full configuration for a connection profile.
|
|
type Profile struct {
|
|
ID string `json:"id"`
|
|
DisplayName string `json:"displayName"`
|
|
Description string `json:"description"`
|
|
Protocol Protocol `json:"protocol"`
|
|
Host string `json:"host"`
|
|
Port int `json:"port"`
|
|
Username string `json:"username"`
|
|
Tags []string `json:"tags"`
|
|
Folder string `json:"folder"`
|
|
Environment string `json:"environment"`
|
|
Notes string `json:"notes"`
|
|
Favourite bool `json:"favourite"`
|
|
LastConnected *time.Time `json:"lastConnected"`
|
|
ConnectTimeout int `json:"connectTimeout"` // seconds
|
|
ReadTimeout int `json:"readTimeout"` // seconds
|
|
CreatedAt time.Time `json:"createdAt"`
|
|
UpdatedAt time.Time `json:"updatedAt"`
|
|
|
|
// Terminal preferences
|
|
TerminalFontFamily string `json:"terminalFontFamily"`
|
|
TerminalFontSize int `json:"terminalFontSize"`
|
|
TerminalScrollback int `json:"terminalScrollback"`
|
|
TerminalCursorStyle string `json:"terminalCursorStyle"`
|
|
|
|
// SSH-specific configuration
|
|
SSH *SSHConfig `json:"ssh,omitempty"`
|
|
|
|
// Telnet-specific configuration
|
|
Telnet *TelnetConfig `json:"telnet,omitempty"`
|
|
|
|
// RAW-specific configuration
|
|
RAW *RAWConfig `json:"raw,omitempty"`
|
|
|
|
// GitHub-specific configuration
|
|
GitHub *GitHubConfig `json:"github,omitempty"`
|
|
}
|
|
|
|
// SSHConfig holds SSH-specific settings for a connection profile.
|
|
type SSHConfig struct {
|
|
AuthMethods []string `json:"authMethods"` // password, publickey, keyboard-interactive
|
|
SecretMode SecretMode `json:"secretMode"`
|
|
PrivateKeyPath string `json:"privateKeyPath"`
|
|
KeySecretMode SecretMode `json:"keySecretMode"`
|
|
HostKeyPolicy HostKeyPolicy `json:"hostKeyPolicy"`
|
|
TerminalType string `json:"terminalType"`
|
|
KeepaliveInterval int `json:"keepaliveInterval"`
|
|
KeepaliveCountMax int `json:"keepaliveCountMax"`
|
|
Compression bool `json:"compression"`
|
|
JumpHosts []JumpHost `json:"jumpHosts"`
|
|
StartupCommand string `json:"startupCommand"`
|
|
EnvVars map[string]string `json:"envVars"`
|
|
}
|
|
|
|
// JumpHost describes a proxy/bastion host used for SSH multi-hop connections.
|
|
type JumpHost struct {
|
|
Host string `json:"host"`
|
|
Port int `json:"port"`
|
|
Username string `json:"username"`
|
|
AuthMethod string `json:"authMethod"`
|
|
SecretMode SecretMode `json:"secretMode"`
|
|
PrivateKeyPath string `json:"privateKeyPath"`
|
|
}
|
|
|
|
// TelnetConfig holds Telnet-specific settings for a connection profile.
|
|
type TelnetConfig struct {
|
|
LocalEcho bool `json:"localEcho"`
|
|
LineEnding LineEnding `json:"lineEnding"`
|
|
TerminalType string `json:"terminalType"`
|
|
Encoding string `json:"encoding"`
|
|
NegotiationDebug bool `json:"negotiationDebug"`
|
|
LineMode bool `json:"lineMode"`
|
|
}
|
|
|
|
// RAWConfig holds RAW TCP-specific settings for a connection profile.
|
|
type RAWConfig struct {
|
|
AutoReconnect bool `json:"autoReconnect"`
|
|
LineEnding LineEnding `json:"lineEnding"`
|
|
Encoding string `json:"encoding"`
|
|
ShowTimestamps bool `json:"showTimestamps"`
|
|
ShowDirection bool `json:"showDirection"`
|
|
PayloadPresets []PayloadPreset `json:"payloadPresets"`
|
|
}
|
|
|
|
// PayloadPreset stores a reusable payload for RAW TCP connections.
|
|
type PayloadPreset struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Payload string `json:"payload"` // base64-encoded for binary safety
|
|
Format string `json:"format"` // text, hex, escaped
|
|
}
|
|
|
|
// GitHubConfig holds GitHub API-specific settings for a connection profile.
|
|
type GitHubConfig struct {
|
|
// BaseURL is the GitHub API base (e.g. "https://api.github.com" for
|
|
// github.com, or "https://github.example.com/api/v3" for GHE).
|
|
BaseURL string `json:"baseURL"`
|
|
|
|
// SecretMode controls how the personal access token is stored.
|
|
SecretMode SecretMode `json:"secretMode"`
|
|
|
|
// RefreshIntervalSecs controls the auto-refresh period in seconds.
|
|
// Defaults to 300 (5 minutes).
|
|
RefreshIntervalSecs int `json:"refreshIntervalSecs"`
|
|
}
|
|
|
|
// GitHubRepo is a single repository returned to the frontend for display.
|
|
type GitHubRepo struct {
|
|
FullName string `json:"fullName"`
|
|
Name string `json:"name"`
|
|
Owner string `json:"owner"`
|
|
Description string `json:"description"`
|
|
HTMLURL string `json:"htmlURL"`
|
|
Private bool `json:"private"`
|
|
Fork bool `json:"fork"`
|
|
Archived bool `json:"archived"`
|
|
Language string `json:"language"`
|
|
Stars int `json:"stars"`
|
|
PushedAt string `json:"pushedAt"` // ISO 8601
|
|
UpdatedAt string `json:"updatedAt"`
|
|
}
|
|
|
|
// SessionState represents the lifecycle state of a connection session.
|
|
type SessionState string
|
|
|
|
const (
|
|
SessionConnecting SessionState = "connecting"
|
|
SessionConnected SessionState = "connected"
|
|
SessionDisconnected SessionState = "disconnected"
|
|
SessionError SessionState = "error"
|
|
)
|
|
|
|
// SessionInfo provides metadata about an active or recent session.
|
|
type SessionInfo struct {
|
|
ID string `json:"id"`
|
|
ProfileID string `json:"profileId"`
|
|
ProfileName string `json:"profileName"`
|
|
Protocol Protocol `json:"protocol"`
|
|
Host string `json:"host"`
|
|
Port int `json:"port"`
|
|
State SessionState `json:"state"`
|
|
TabName string `json:"tabName"`
|
|
Pinned bool `json:"pinned"`
|
|
ConnectedAt time.Time `json:"connectedAt"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
// KnownHost records a previously-seen SSH host key fingerprint.
|
|
type KnownHost struct {
|
|
ID string `json:"id"`
|
|
Host string `json:"host"`
|
|
Port int `json:"port"`
|
|
KeyType string `json:"keyType"`
|
|
Fingerprint string `json:"fingerprint"`
|
|
PublicKey string `json:"publicKey"`
|
|
FirstSeen time.Time `json:"firstSeen"`
|
|
LastSeen time.Time `json:"lastSeen"`
|
|
Trusted bool `json:"trusted"`
|
|
}
|
|
|
|
// AppPreferences stores user-level application settings.
|
|
type AppPreferences struct {
|
|
Theme string `json:"theme"`
|
|
DefaultProtocol string `json:"defaultProtocol"`
|
|
ConfirmOnClose bool `json:"confirmOnClose"`
|
|
ConfirmOnDisconnect bool `json:"confirmOnDisconnect"`
|
|
ShowStatusBar bool `json:"showStatusBar"`
|
|
SidebarWidth int `json:"sidebarWidth"`
|
|
DefaultFontFamily string `json:"defaultFontFamily"`
|
|
DefaultFontSize int `json:"defaultFontSize"`
|
|
DefaultScrollback int `json:"defaultScrollback"`
|
|
DefaultCursorStyle string `json:"defaultCursorStyle"`
|
|
}
|
|
|
|
// AuditEntry records an auditable action within the application.
|
|
type AuditEntry struct {
|
|
ID string `json:"id"`
|
|
Timestamp time.Time `json:"timestamp"`
|
|
Action string `json:"action"`
|
|
ProfileID string `json:"profileId,omitempty"`
|
|
SessionID string `json:"sessionId,omitempty"`
|
|
Details string `json:"details"`
|
|
}
|