Rocket.Chat Apps Engine
The engine which manages and controls everything....more details coming soon.
Thoughts While Working (for docs)
- Apps which don't provide a valid uuid4 id will be assigned one, but this is not recommended and your App should provide an id
- The language strings are only done on the clients (
TAPi18next.addResourceBundle(lang, projectName, translations);)
- The implementer of this should restrict the server setting access and environmental variables. Idea is to allow the implementer to have a default set of restricted ones while letting the admin/owner of the server to restrict it even further or lift the restriction on some more. Simple interface with settings and checkbox to allow/disallow them.
To Think About?
- Will we support es6? Since we currently check
extendskeyword and can check
implementsvia determing what methods exist
- Using https://www.npmjs.com/package/jsonc-parser for the json parsing?
Implementer Needs to Implement:
Makes great usage of TypeScript and decorators: https://github.com/alsatian-test/alsatian/wiki
- To run the tests do:
npm run unit-tests
- To generate the coverage information:
npm run check-coverage
- To view the coverage:
npm run view-coverage
Rocket.Chat Apps TypeScript Definitions
Handlers are essentially "listeners" for different events, except there are various ways to handle an event.
When something happens there is
The set of
pre handlers happens before the event is finalized.
The set of
post handlers happens after the event is finalized.
With that said, the rule of thumb is that if you are going to modify, extend, or change the data backing the event then that should be done in the
pre handlers. If you are simply wanting to listen for when something happens and not modify anything, then the
post is the way to go.
The order in which they happen is:
Here is an explanation of what each of them means:
- Prevent: This is ran to determine whether the event should be prevented or not.
- Extend: This is ran to allow extending the data without being destructive of the data (adding an attachment to a message for example).
- Modify: This is ran and allows for destructive changes to the data (change any and everything).
- PostEvent: Is mostly for simple listening and no changes can be made to the data.
To update or generate the documentation, please commit your changes first and then in a second commit provide the updated documentation.