CovidBracelet/src/ens/storage.h

#ifndef CONTACT_STORAGE_H
#define CONTACT_STORAGE_H

#include "../contacts.h"  // Requires contact_t in contacts.h!
#include "../covid_types.h"
#include "sequencenumber.h"

typedef uint16_t storage_id_t;

// TODO lome: own datatype for storage
typedef struct record {
    record_sequence_number_t sn;  // TODO: Convert Sequence Number
    uint32_t timestamp;           // TODO: Seconds from january first 2000 (UTC+0)
    rssi_t rssi;                  // TODO: Check correct
    rolling_proximity_identifier_t rolling_proximity_identifier;
    associated_encrypted_metadata_t associated_encrypted_metadata;
} record_t;

typedef struct stored_contacts_information {
    record_sequence_number_t oldest_contact;
    record_sequence_number_t count;
} stored_contacts_information_t;

/**
 * Initializes the contact storage component
 * @return 0 for success
 */
int init_contact_storage();

/**
 * Loads the contact with number sn into the destination struct
 * @param dest
 * @param sn
 * @return 0 in case of success
 */
int load_contact(record_t* dest, record_sequence_number_t sn);

/**
 * Stores the contact from src with number sn, increases latest sequence number
 * @param sn
 * @param src
 * @return 0 in case of success
 */
int add_contact(record_t* src);

/**
 * Deletes the contact from storage with number sn
 * @param sn the sequence number to delete
 * @return 0 in case of success
 */
int delete_contact(record_sequence_number_t sn);

/**
 * TODO: How to handle if none is available?
 * @return The latest available sequence number (Caution: can actually be lower than the oldes in case of a
 * wrap-around!)
 */
record_sequence_number_t get_latest_sequence_number();

/**
 * TODO: How to handle if none is available?
 * @return The oldest available sequence number
 */
record_sequence_number_t get_oldest_sequence_number();

/**
 * TODO: How to handle if none is available?
 * @return The amount of contacts, usually get_latest_sequence_number() - get_oldest_sequence_number()
 */
uint32_t get_num_contacts();

#endif