/* storage.h - C-ABI boundary between Storage Engine (C) and Engine Logic (C++) */
#ifndef PAULDB_STORAGE_H
#define PAULDB_STORAGE_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C"
{
#endif

    /* --- Page Management --- */
    typedef struct Page Page;

    Page*
    page_create(uint32_t page_id);

    int
    page_insert(Page* p, const void* data, size_t len);

    void*
    page_get(Page* p, uint16_t slot_id, size_t* out_len);

    void
    page_free(Page* p);

    /* --- Heap (Multi-Page Row Store / Delta) --- */
    typedef struct Heap Heap;

    Heap*
    heap_create(void);

    int
    heap_insert(Heap* h, const void* data, size_t len);

    void
    heap_full_scan(Heap* h, void (*callback)(const void*, size_t));

    void
    heap_free(Heap* h);

    /* --- B+Tree Index --- */
    typedef struct BTree BTree;

    BTree*
    btree_create(void);

    int
    btree_insert(BTree* bt, int64_t key, uint32_t page_id, uint16_t slot_id);

    int
    btree_lookup(BTree* bt, int64_t key, uint32_t* out_page, uint16_t* out_slot);

    void
    btree_free(BTree* bt);

#ifdef __cplusplus
}
#endif

#endif /* PAULDB_STORAGE_H */