client

package

v0.0.1 Latest Latest Go to latest Published: Aug 25, 2026 License: Apache-2.0 Imports: 9 Imported by: 0

Details

Package client provides an HTTP client for the pulse server API.

This section is empty.

This section is empty.

This section is empty.

type Client struct {
	ServerURL string
	// contains filtered or unexported fields
}

Client is an HTTP client for the pulse server.

func New(serverURL string) *Client

New creates a new pulse client for the given server URL.

func (c *Client) EnsureToken() error

EnsureToken loads and refreshes the token if needed.

func (c *Client) LoadToken() error

LoadToken reads the saved authentication token from disk.

func (c *Client) RefreshToken() error

RefreshToken exchanges the current token for a new one.

func (c *Client) SaveToken(token string, expiresAt time.Time) error

SaveToken persists the authentication token to disk.

func (c *Client) SendPulse(count int64, hostname string) error

SendPulse submits a keystroke count to the server.

func (c *Client) ShouldRefresh() bool

ShouldRefresh reports whether the token needs refreshing.

func (c *Client) Token() string

Token returns the current authentication token string.

type TokenData struct {
	Token     string    `json:"token"`
	ExpiresAt time.Time `json:"expires_at"`
	SavedAt   time.Time `json:"saved_at"`
}

TokenData holds authentication token data with expiration info.