Document all uses of badgekit client in PaperBadger

[josmas]

Inspect the PaperBadger code to see where the badgekit api client is used (identify all current calls).
Once we know all current uses, we can prioritise additions to this module.
Document the uses as replies to this issue.

[drammock]

My JS-fu may be too weak to do this task well, but here's a start:

• calls:
  • most of them seem to be in src/app.js (here) which lead to src/routes/*/index.js where * is [badges, papers, users, claims]
• mentions:
  • src/badges/client/index.js is where ApiClient gets initialized
  • bin/load_badges.sql: "badgekit" is set as slug in the systems table
  • BADGES_ENDPOINT and BADGES_SYSTEM environment vars (in default.env, README.md)

[josmas]

Thanks @drammock

Following up on that; most of the client calls are done in service/index.js.

Actual calls:
client.createBadgeInstance(context, function (err, badgeResult) { [...] })
client.getBadgeInstances(context, options, clientCallback)
client.getAllBadges({ [...] })

[josmas]

These three functions are now part of the library, which is already on npm.