docs: first API draft

[ttypic]

No description provided.

[AndyTWF]

A bit of a general question - how do we see the customer application interacting with the library? Lets say I wanted to "scroll up" my chat and get some older messages - would I just do a query at appropriate points to populate the messages?

How would huge volumes of messages be handled - lets say a user decided to scroll all the way up a chat (containing say millions of messages), would the client library try to hold every message in memory? Or would we make it some sort of sparse cache, that may not contain all messages - but is guaranteed to contain the latest version of a message if it does have it?

That sorta leads me on to a thought - do we make the client library implement a "window" of messages? Like, the customer tells the library which window of messages the user is currently in, and the library only generates events for messages in that window? Thus it keeps the number of messages the library has in memory to a fixed size?