From c375b1c69665ae7c16ffa3f17264386dfc257d8e Mon Sep 17 00:00:00 2001
From: Marcos Magueta <maguetamarcos@gmail.com>
Date: Sat, 9 May 2026 23:03:00 -0300
Subject: FOL VM with cursor mocked storage

---
 include/Types.h | 43 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 39 insertions(+), 4 deletions(-)

(limited to 'include/Types.h')

diff --git a/include/Types.h b/include/Types.h
index 9d55765..c6f4b9f 100644
--- a/include/Types.h
+++ b/include/Types.h
@@ -1,8 +1,11 @@
 #pragma once
 
+#include <string>
+#include <vector>
+
 /**
  * @file Types.h
- * @brief Shared enum types used by the runtime managers.
+ * @brief Shared enum types and core data types used by the runtime.
  */
 
 /** @brief Runtime object categories known by the object manager. */
@@ -11,9 +14,7 @@ enum OBJECT_TYPE {
     MULTIGROUP,
     /** A relation object. */
     RELATION,
-    /** A tuple object. */
-    TUPLE,
-    /** An attribute object. */
+    /** An attribute object (schema metadata). */
     ATTRIBUTE,
     /** A transaction object. */
     TRANSACTION
@@ -46,3 +47,37 @@ enum AUTH_METHOD {
     /** Plain-text authentication. */
     PLAIN_TEXT
 };
+
+namespace nt
+{
+    /** @brief A single named value in a tuple, produced by the cursor layer. */
+    struct Attribute {
+        std::string name;
+        std::string value;
+    };
+
+    /**
+     * @brief A single row of data streamed lazily from the cursor layer.
+     *
+     * Follows the Volcano pull model: callers repeatedly call Next() to consume
+     * one attribute at a time. Returns nullptr when all attributes are exhausted.
+     */
+    class Tuple {
+    public:
+        explicit Tuple(std::vector<Attribute> attributes)
+            : attributes_(std::move(attributes)) {}
+
+        /** @brief Returns the next attribute, or nullptr when exhausted. */
+        const Attribute* Next() {
+            if (position_ < attributes_.size())
+                return &attributes_[position_++];
+            return nullptr;
+        }
+
+        void Reset() { position_ = 0; }
+
+    private:
+        std::vector<Attribute> attributes_;
+        size_t position_ = 0;
+    };
+}
-- 
cgit v1.2.3