analytics.hpp

Go to the documentation of this file.

#pragma once
 
// Analytics — thread-safe event tracking with pluggable destinations.
 
#include <string>
#include <string_view>
#include <vector>
#include <map>
#include <memory>
#include <functional>
#include <mutex>
#include <chrono>
#include <cstdint>
 
namespace pulp::runtime {

struct AnalyticsEvent {
    std::string name;
    std::map<std::string, std::string> properties;
    double timestamp = 0;  // Unix epoch seconds
};

class AnalyticsDestination {
public:
    virtual ~AnalyticsDestination() = default;
    virtual void log_event(const AnalyticsEvent& event) = 0;
    virtual void flush() {}
};

class FileAnalyticsDestination : public AnalyticsDestination {
public:
    explicit FileAnalyticsDestination(std::string_view path);
    void log_event(const AnalyticsEvent& event) override;
    void flush() override;
private:
    std::string path_;
    std::vector<AnalyticsEvent> buffer_;
    std::mutex mutex_;
};

class Analytics {
public:
    static Analytics& instance();

    void add_destination(std::unique_ptr<AnalyticsDestination> dest);

    void log_event(std::string_view name,
                   const std::map<std::string, std::string>& properties = {});

    void log(std::string_view name);

    void flush();

    void set_enabled(bool enabled) { enabled_ = enabled; }
    bool is_enabled() const { return enabled_; }

    uint64_t event_count() const { return event_count_; }
 
private:
    Analytics() = default;
    std::vector<std::unique_ptr<AnalyticsDestination>> destinations_;
    std::mutex mutex_;
    bool enabled_ = true;
    uint64_t event_count_ = 0;
};

class WidgetTracker {
public:
    static void track_click(std::string_view widget_id);

    static void track_value_change(std::string_view widget_id, std::string_view value);

    static void track_preset_select(std::string_view preset_name);
};
 
}  // namespace pulp::runtime