exoplatform-api-wrapper
TypeScript icon, indicating that this package has built-in type declarations

0.1.8 • Public • Published

exoplatform-api-wrapper

npm badge Build Status

A wrapper for the API of the Open source Enterprise Social Network of eXo Platform. It covers the Social REST API, which is badly documented.

It is entirely built from TypeScript and fully tested. API responses are typed, so you can get full auto-completion in your code editor.

This project is dependency-free.

Install

yarn add exoplatform-api-wrapper
# or 
npm i exoplatform-api-wrapper

Usage

The example below shows how to get activities available in a user's feed.

import ExoPlatformWrapper from 'exoplatform-api-wrapper'
 
const setup = async () => {
  const exoWrapper = new ExoPlatformWrapper('www.example.com')
  await exoWrapper.login('myUsername', 'myPassword')
  const { activities } = await exoWrapper.user.readStream()
  console.log(activities)
}
 
setup()

Documentation

See rigwild.github.io/exoplatform-api-wrapper.

Full API coverage/example is available in the automated tests: ./test/tests.ts.

Running tests

You must configure the tests by setting the following environment variables.

Environment variable Description Required Default Example
EXO_HOSTNAME eXo Platform social network hostname (no protocol://) ✅ www.example.com
EXO_PATH eXo Platform API path ❌ /rest /exo/platform/rest
EXO_USERNAME eXo Platform account username ✅ myUser
EXO_PASSWORD eXo Platform account password ✅ myPassword
EXO_SECURE_PROTOCOL SSL protocol to use (do not touch if you don't know what it is!!) ❌ undefined TLSv1_method
EXO_CIPHERS SSL ciphers to use (do not touch if you don't know what it is!!) ❌ undefined AES128-SHA

Then, you can run the tests:

yarn test
# or 
npm run test

Notice

The author of this library is not affiliated in any way with eXo Platform.

Contributing

If you found a bug or want any features not available yet, feel free to open an issue documentating the problem.

You may also contribute to the project by opening a Pull Request.

License

The MIT license

Dependencies (0)

    Dev Dependencies (5)

    Package Sidebar

    Install

    npm i exoplatform-api-wrapper

    Weekly Downloads

    0

    Version

    0.1.8

    License

    MIT

    Unpacked Size

    59.6 kB

    Total Files

    31

    Last publish

    Collaborators

    • rigwild