client

Documentation

Index

• func CachePath(filename string) (string, error)
• func ConfigDir() (string, error)
• func ConfigPath() (string, error)
• func LoadAudioUploads(paths []string) ([]*proto.AudioUpload, error)
• func LoadImageUploads(paths []string) ([]*proto.ImageUpload, error)
• type Config
  • func LoadConfig() *Config
  • func (c *Config) DeletePost(ctx context.Context, pageID string) error
  • func (c *Config) GetPostFullContent(ctx context.Context, pageID string) (string, error)
  • func (c *Config) GetRandomPosts(ctx context.Context, count int) ([]*Post, error)
  • func (c *Config) ListPosts(ctx context.Context, count int) ([]*Post, error)
  • func (c *Config) SaveEntry(ctx context.Context, text string, imagePaths, audioPaths []string) error
  • func (c *Config) SearchPosts(ctx context.Context, query string, maxResults int) ([]*Post, error)
  • func (c *Config) TimeSinceLastPost(ctx context.Context) (time.Duration, error)
  • func (c *Config) UpdateCache(ctx context.Context) error
  • func (c *Config) Validate() error
• type ConfigFile
  • func SaveConfig(apiKey, grpcTarget string) (*ConfigFile, error)
• type Post

Functions

func CachePath

func CachePath(filename string) (string, error)

CachePath returns the path for a cache file under the config directory. Example: CachePath("timesince.cache") => ~/.config/etu/timesince.cache

func ConfigDir

func ConfigDir() (string, error)

ConfigDir returns the etu config directory (e.g. ~/.config/etu on Unix). Creates the directory if it does not exist. Use this for config and cache files.

func ConfigPath

func ConfigPath() (string, error)

ConfigPath returns the path to the config file (~/.config/etu/config.json).

func LoadAudioUploads

func LoadAudioUploads(paths []string) ([]*proto.AudioUpload, error)

LoadAudioUploads reads audio files from paths and returns proto AudioUpload messages. MIME type is detected from content (or file extension as fallback).

func LoadImageUploads

func LoadImageUploads(paths []string) ([]*proto.ImageUpload, error)

LoadImageUploads reads image files from paths and returns proto ImageUpload messages. MIME type is detected from content (or file extension as fallback).

Types

type Config

type Config struct {
	ApiKey     string
	GRPCTarget string
	// contains filtered or unexported fields
}

Config holds the configuration for the client.

func LoadConfig

func LoadConfig() *Config

LoadConfig loads configuration from ~/.config/etu/config.json and environment variables. Env ETU_API_KEY and ETU_GRPC_TARGET override file values. If no config file exists and no API key is set, a config file is created with the correct structure and an empty key.

func (*Config) DeletePost

func (c *Config) DeletePost(ctx context.Context, pageID string) error

DeletePost deletes a journal entry by ID.

func (*Config) GetPostFullContent

func (c *Config) GetPostFullContent(ctx context.Context, pageID string) (string, error)

GetPostFullContent fetches the full content of a post by ID.

func (*Config) GetRandomPosts

func (c *Config) GetRandomPosts(ctx context.Context, count int) ([]*Post, error)

GetRandomPosts fetches random journal entries from the backend.

func (*Config) ListPosts

func (c *Config) ListPosts(ctx context.Context, count int) ([]*Post, error)

ListPosts lists the most recent journal entries.

func (*Config) SaveEntry

func (c *Config) SaveEntry(ctx context.Context, text string, imagePaths, audioPaths []string) error

SaveEntry saves a new journal entry via the backend (tags are generated on the backend). imagePaths and audioPaths are optional paths to image and audio files to attach to the note.

func (*Config) SearchPosts

func (c *Config) SearchPosts(ctx context.Context, query string, maxResults int) ([]*Post, error)

SearchPosts searches journal entries via the backend.

func (*Config) TimeSinceLastPost

func (c *Config) TimeSinceLastPost(ctx context.Context) (time.Duration, error)

TimeSinceLastPost returns the time since the last post was created.

func (*Config) UpdateCache

func (c *Config) UpdateCache(ctx context.Context) error

UpdateCache updates the cache with the latest post.

func (*Config) Validate

func (c *Config) Validate() error

Validate checks that the API key is present.

type ConfigFile

type ConfigFile struct {
	APIKey     string `json:"api_key"`
	GRPCTarget string `json:"grpc_target"`
}

configFile represents the persisted config file format.

func SaveConfig

func SaveConfig(apiKey, grpcTarget string) (*ConfigFile, error)

SaveConfig writes api_key and grpc_target to ~/.config/etu/config.json. Creates the config directory if it does not exist.

type Post

type Post struct {
	PageID    string // Note ID for fetching full content
	Tags      []string
	Text      string
	CreatedAt time.Time
	Images    []*proto.NoteImage
	Audios    []*proto.NoteAudio
}

Post represents a journal entry (display model for TUI/CLI).