transaction.h

Go to the documentation of this file.

#pragma once

 
#include "fl/stl/limits.h"
#include "fl/stl/stdint.h"
#include "fl/stl/unique_ptr.h"
#include "fl/stl/result.h"
#include "fl/stl/optional.h"
#include "fl/task/promise.h"  // for fl::task::Error
#include "fl/stl/noexcept.h"
 
namespace fl {
 
// Forward declaration for SPIError
enum class SPIError : u8;
 
namespace spi {
 
// Forward declaration
class Device;
 
// Type alias for SPI-specific Result type (matches spi.h)
template<typename T>
using Result = fl::result<T, SPIError>;
 
// ============================================================================
// Transaction Class (Async Operations)
// ============================================================================

class Transaction {
public:
    bool wait(u32 timeout_ms = (fl::numeric_limits<u32>::max)());

    bool isDone() const;

    bool isPending() const;

    bool cancel();

    fl::optional<fl::task::Error> getResult() const;

    ~Transaction();
 
    // Move semantics
    Transaction(Transaction&& other) FL_NOEXCEPT;
    Transaction& operator=(Transaction&& other) FL_NOEXCEPT;
 
private:
    friend class Device;
 
    // Private constructor for Device to create transactions
    Transaction() FL_NOEXCEPT;
 
    struct Impl;
    fl::unique_ptr<Impl> pImpl;
 
    // Non-copyable
    Transaction(const Transaction&) FL_NOEXCEPT = delete;
    Transaction& operator=(const Transaction&) FL_NOEXCEPT = delete;
};
 
} // namespace spi
} // namespace fl