groupme-js / node-groupme

The only GroupMe API library for NodeJS that isn't a million years old.
https://groupme.js.org
MIT License
27 stars 11 forks source link

API coverage checklist #1

Open not-so-smart opened 3 years ago

not-so-smart commented 3 years ago

Current state of API coverage

Groups

Members

Chats

Users

Likes

Calendar

Account

Polls

Attachments

Push

Miscellaneous and v4 stuff

Bots (ignored for now)

AlureonTheVirus commented 1 year ago

not that I can speak for the project but I'd like to add that groupme has also added subgroups as what it calls "topics".

I assume that we will want to have websocket support at some point built in. A more Event-Driven approach would make bot development with this library a lot simpler and more straightforward/intuitive. (Let me know if I'm wrong and that's already implemented.)

It also seems that this project lacks a lot of in depth documentation and examples that other API wrappers typically have. (Not a diss, just an observation and possibly another goal to work towards.)

not-so-smart commented 1 year ago

not that I can speak for the project but I'd like to add that groupme has also added subgroups as what it calls "topics".

Thank you! Yes, we do want to add support for topics, currently there is no framework for it but feel free to open a PR if you'd like to get that started :)

I assume that we will want to have websocket support at some point built in. A more Event-Driven approach would make bot development with this library a lot simpler and more straightforward/intuitive. (Let me know if I'm wrong and that's already implemented.)

Good news! The PR for websockets (#104) is currently open and will be merged soon! :D

It also seems that this project lacks a lot of in depth documentation and examples that other API wrappers typically have. (Not a diss, just an observation and possibly another goal to work towards.)

Yes, as you can see from this checklist, a lot of the framework (files, classes and method stubs to shape the relevant data structures) and even most of the implementation (filling in those method stubs with code that interacts with the API) is currently missing. API coverage is a slightly higher priority than documentation at this stage, but we do have docs at https://groupme.js.org/ which are automatically generated on each release and built from TS type information (for classes and their properties) along with any JSdoc comments present in the code (for descriptions of these objects and example usage). If you want to add to this documentation, just open a PR adding comments following the JSdoc standard (https://jsdoc.app/) and they'll be added to the generated docs in the next build.