🛠️ [TASK] : Define the initial API surface for the crate (See Description for high level overview of API requirements).

[stevenj]

Summary

Defines the high level API for all planned api functions

Description

Functions should effectively be No-ops, and not have any real functionality yet.
It just defines the configuration structures and the API surface itself.
At the end of this the API should be fully defined and properly documented and Rust docs being produced.
Review of the produced rust-docs will be necessary to sign off on this task.

This task is better as a collaborative effort between 2 developers, with a review by the whole team following that.
API to follow architectural guidance.