#pragma once #include #include #include #include #include #include #if !defined(extra_assert) #if defined(EXTRA_ASSERTS) && EXTRA_ASSERTS == 1 #define extra_assert(...) assert(__VA_ARGS__) #else #define extra_assert(...) void(0) #endif #endif namespace GreenCRDT::V4 { template struct List { // for public interface struct ListID { ActorType id; uint64_t seq{0}; // strictly increasing for that actor bool operator<(const ListID& rhs) const { if (seq < rhs.seq) { return true; } else if (seq > rhs.seq) { return false; } else { // == return id < rhs.id; } } bool operator==(const ListID& rhs) const { return seq == rhs.seq && id == rhs.id; } bool operator!=(const ListID& rhs) const { return seq != rhs.seq || id != rhs.id; } }; struct ListIDInternal { size_t actor_idx{0}; uint64_t seq{0}; // strictly increasing for that actor bool operator==(const ListIDInternal& rhs) const { return seq == rhs.seq && actor_idx == rhs.actor_idx; } }; // internally the index into this array is used to refer to an actor std::vector _actors; // range struct Entry { ListIDInternal id; std::vector values; bool deleted {false}; // Yjs std::optional parent_left; std::optional parent_right; }; // TODO: use something better, edit: this seems fine std::vector _list; // number of not deleted entries size_t _doc_size {0}; // TODO: actor index instead of map std::unordered_map _last_seen_seq; // caching only, contains the last index an actor inserted at std::unordered_map _last_inserted_idx; //size_t _stat_find_with_hint{0}; //size_t _stat_find_with_hint_hit{0}; std::optional findActor(const ActorType& actor) const { for (size_t i = 0; i < _actors.size(); i++) { if (_actors[i] == actor) { return i; } } return std::nullopt; } std::optional findIdx(const ListIDInternal& list_id) const { extra_assert(verify()); for (size_t i = 0; i < _list.size(); i++) { if ( _list[i].id.actor_idx == list_id && // same actor list_id.seq >= _list[i].id.seq && // in range seen from left list_id.seq < _list[i].id.seq + _list[i].values.size() // in range seen from right ) { return i; } } return std::nullopt; } // search close to hint first std::optional findIdx(const ListIDInternal& list_id, size_t hint) const { extra_assert(verify()); //_stat_find_with_hint++; // TODO: find NEW magic values static constexpr size_t c_hint_pre = 1; static constexpr size_t c_hint_post = 4; if (hint >= c_hint_pre) { hint -= c_hint_pre; } const size_t max_at_hint = hint + c_hint_post; // how many positions we check at hint, before falling back to full lookup for (size_t i = hint; i <= max_at_hint && i < _list.size(); i++) { if (_list[i].id == list_id) { //_stat_find_with_hint_hit++; return i; } } // fall back to normal search return findIdx(list_id); } std::optional findIdx(const ListID& list_id) const { extra_assert(verify()); const auto actor_idx_opt = findActor(list_id.id); if (!actor_idx_opt.has_value()) { return std::nullopt; } const ListIDInternal tmp_id {actor_idx_opt.value(), list_id.seq}; return findIdx(tmp_id); } std::optional findIdx(const ListID& list_id, size_t hint) const { extra_assert(verify()); const auto actor_idx_opt = findActor(list_id.id); if (!actor_idx_opt.has_value()) { return std::nullopt; } const ListIDInternal tmp_id {actor_idx_opt.value(), list_id.seq}; return findIdx(tmp_id, hint); } // returns false if missing OPs // based on YjsMod https://github.com/josephg/reference-crdts/blob/9f4f9c3a97b497e2df8ae4473d1e521d3c3bf2d2/crdts.ts#L293-L348 // which is a modified Yjs(YATA) algo bool add(const ListID& list_id, const ValueType& value, const std::optional& parent_left, const std::optional& parent_right) { extra_assert(verify()); size_t actor_idx {0}; { // new actor? // add, even if op fails const auto actor_opt = findActor(list_id.id); if (!actor_opt.has_value()) { actor_idx = _actors.size(); _last_inserted_idx[_actors.size()] = 0; // hack _actors.push_back(list_id.id); } else { actor_idx = actor_opt.value(); } } // check actor op order if (!_last_seen_seq.count(actor_idx)) { // we dont know this actor yet, first seq needs to be 0 if (list_id.seq != 0) { return false; } } else { // making sure we dont skip operations by that actor if (list_id.seq != _last_seen_seq.at(actor_idx) + 1) { return false; } } size_t insert_idx = 0; if (_list.empty()) { if (parent_left.has_value() || parent_right.has_value()) { // empty, missing parents return false; } } else { // find left std::optional left_idx_opt = std::nullopt; if (parent_left.has_value()) { left_idx_opt = findIdx(parent_left.value(), _last_inserted_idx[actor_idx]); if (!left_idx_opt.has_value()) { // missing parent left return false; } // we insert before the it, so we need to go past the left parent insert_idx = left_idx_opt.value() + 1; } // else insert_idx = 0 const size_t left_idx_hint = insert_idx; // find right size_t right_idx = _list.size(); if (parent_right.has_value()) { auto tmp_right = findIdx(parent_right.value(), left_idx_hint); if (!tmp_right.has_value()) { return false; } right_idx = tmp_right.value(); } bool scanning {false}; for(size_t i = insert_idx;; i++) { if (!scanning) { insert_idx = i; } // if right parent / end of doc, insert if (insert_idx == right_idx) { break; } // we ran past right o.o ? if (insert_idx == _list.size()) { break; } const Entry& at_i = _list[i]; // parents left and right std::optional i_left_idx {std::nullopt}; if (at_i.parent_left.has_value()) { i_left_idx = findIdx(at_i.parent_left.value(), left_idx_hint); if (!i_left_idx.has_value()) { assert(false && "item in list with unknown parent left!!"); return false; } } // possibility map // // | ir < r | ir == r | ir > r // ------------------------------------- // il < l | insert | insert | insert // il == l | ? | agentfallback | ? // il > l | skip | skip | skip if (i_left_idx < left_idx_opt) { break; } else if (i_left_idx == left_idx_opt) { // get i parent_right size_t i_right_idx = _list.size(); if (at_i.parent_right.has_value()) { auto tmp_right = findIdx(at_i.parent_right.value(), insert_idx); if (!tmp_right.has_value()) { assert(false && "item in list with unknown parent right!!"); return false; } i_right_idx = tmp_right.value(); } if (i_right_idx < right_idx) { scanning = true; } else if (i_right_idx == right_idx) { // actor id tie breaker if (_actors[actor_idx] < _actors[at_i.id.actor_idx]) { break; } else { scanning = false; } } else { // i_right_idx > right_idx scanning = false; } } else { // il > l // do nothing } } } { // actual insert Entry new_entry; new_entry.id.actor_idx = actor_idx; new_entry.id.seq = list_id.seq; if (parent_left.has_value()) { new_entry.parent_left = ListIDInternal{findActor(parent_left.value().id).value(), parent_left.value().seq}; } if (parent_right.has_value()) { new_entry.parent_right = ListIDInternal{findActor(parent_right.value().id).value(), parent_right.value().seq}; } new_entry.value = value; _list.emplace(_list.begin() + insert_idx, new_entry); _last_inserted_idx[actor_idx] = insert_idx; } _doc_size++; _last_seen_seq[actor_idx] = list_id.seq; extra_assert(verify()); return true; } // returns false if not found bool del(const ListID& id) { extra_assert(verify()); auto actor_idx_opt = findActor(id.id); if (!actor_idx_opt.has_value()) { // we dont have anything with that actor return false; } const ListIDInternal tmp_id {actor_idx_opt.value(), id.seq}; for (auto& it : _list) { if (it.id == tmp_id) { if (it.value.has_value()) { it.value.reset(); _doc_size--; extra_assert(verify()); return true; } else { extra_assert(verify()); return false; // TODO: allow double deletes?,,,, need ids } } } extra_assert(verify()); return false; } size_t getDocSize(void) const { return _doc_size; } std::vector getArray(void) const { std::vector array; for (const auto& e : _list) { if (e.value.has_value()) { array.push_back(e.value.value()); } } return array; } // TODO: only in debug? bool verify(void) const { size_t actual_size = 0; for (const auto& it : _list) { if (it.value.has_value()) { actual_size++; } } //assert(doc_size == actual_size); return _doc_size == actual_size; } }; } // GreenCRDT::V1