TrayIcon.hpp

1. Overview

StatusNotifierItem and DBusMenu implementation built directly on systemd sd-bus. It exposes the BastionGuard tray icon, tooltip, activation actions, persistent-startup action, and quit command.

File role: Header Interface. The file contains 131 lines and belongs to the TrayIcon.hpp path.

The companion file is TrayIcon.cpp.

2. Component Responsibilities

Declare the component API, owned state, callbacks, and data structures.
Generate a unique D-Bus service name
Acquire the user session bus and request the service name
Export StatusNotifierItem and DBusMenu objects
Register with the desktop StatusNotifierWatcher
Process D-Bus traffic in a dedicated worker thread
Marshal menu callbacks back to the bound GLib UI context
Unexport objects and release the bus during shutdown

3. Dependencies and Integration

Project-level dependencies:

systemd/sd-bus.h
glib.h

System and library dependencies:

atomic
functional
string
thread
vector

4. Declared Types

TrayIcon

Declares a class.

5. Constants and Fixed Configuration

The file declares or uses the following fixed values:

static constexpr int MENU_ROOT = 0;

static constexpr int MENU_SHOW = 1;

static constexpr int MENU_PERSIST_STARTUP = 2;

static constexpr int MENU_QUIT = 3;

6. Owned State and UI Members

Threading, dispatch, and callback state

GMainContext* ui_ctx_ = nullptr;
std::thread bus_thread_;
std::atomic_bool running_{false};

Data and configuration state

std::string service_name_;
std::string id_ = "bastionguard-sc";
std::string title_ = "BastionGuardâ¢ Secure Connection";
std::string icon_name_ = "security-high";
std::string tooltip_ = "BastionGuardâ¢ Secure Connection";
std::string status_ = "Active";
bool have_pixmap_ = false;
int pix_w_ = 0;
int pix_h_ = 0;
std::vector<uint8_t> pix_rgba_;
sd_bus* bus_ = nullptr;
sd_bus_slot* sni_slot_ = nullptr;
sd_bus_slot* menu_slot_ = nullptr;
static constexpr int MENU_ROOT = 0;
static constexpr int MENU_SHOW = 1;
static constexpr int MENU_PERSIST_STARTUP = 2;
static constexpr int MENU_QUIT = 3;

7. Signals and Event Integration

The file exposes or connects the following signal-related elements:

void emit_sni_signal(const char* signal_name);

GTK-facing callbacks must execute on the main UI context. Components with worker threads use dispatchers or idle callbacks to cross the thread boundary.

8. Functions and Methods

The file exposes or implements 36 detected function or method signatures.

1. TrayIcon

TrayIcon()

Implements the tray icon operation declared by this component.

2. ~TrayIcon

~TrayIcon()

Releases resources owned by the object and stops any active background integration.

3. start

bool start()

Starts start and activates the associated runtime resources.

4. stop

void stop()

Stops stop and releases or signals its active resources.

5. set_icon

void set_icon(const std::string& icon_name)

Updates icon and synchronizes dependent state.

6. set_icon_file

void set_icon_file(const std::string& png_path, int target_px = 22)

Updates icon file and synchronizes dependent state.

7. set_tooltip

void set_tooltip(const std::string& text)

Updates tooltip and synchronizes dependent state.

8. set_title

void set_title(const std::string& title)

Updates title and synchronizes dependent state.

9. bind_ui_context

void bind_ui_context()

Binds ui context to the active execution context.