Core library for building microfeedback backends.
In short: an easily-deployable HTTP microservice for collecting user feedback about your apps.
Requires Node>=8.
npm install microfeedback-core --save
The microfeedback function is the only public API. It takes a backend function which contains the code to handle user feedback (e.g. post a GitHub issue, send an email) sent from a client.
The second argument, attributes, is an Object that describes the backend (e.g. name, version, description).
The first argument to the backend function
contains the input which will contain--at a minimum--an entry named body with the feedback content.
If the PERSPECTIVE_API_KEY environment variable is set, the first
argument will contain a perspective Object with information
returned from the Perspective API.
If the AKISMET_API_KEY environment variable is set, input will be
checked with the Akismet API. If spam is detected, an error response
will be returned. If the ALLOW_SPAM environment variable is set, an
error response will not be returned and the first argument to the
backend will contain an akismet Object of the form {spam: Boolean}.
Perspective and Akismet support can be disabled by setting
PERSPECTIVE_ENABLED=false and AKISMET_ENABLED=false in the
environment.
The backend function also receives the request (req) and response (res) objects.
See the node http docs for more information about these objects.
The microfeedback function returns a micro request handler.
// index.js
const { createError } = require('micro');
const microfeedback = require('microfeedback');
const sendEmail = require('./email-library');
const EmailBackend = async ({input, perspective, akismet}, req, res) => {
const {name, body} = input;
const toxicity = perspective ? perspective.toxicity : null;
const email = process.env.FEEDBACK_EMAIL; // where to receive feedback
const subject = '[microfeedback] Feedback posted' + name ? `by ${name}` : '';
const content = `${name} posted feedback on your app:
${body}
${toxicity ? `Toxicity rating: ${toxicity}` : ''}
Cheers,
The microfeedback Robot`;
try {
const result = await sendEmail(email, {subject, content});
return { status: result.status };
} catch (err) {
throw createError(400, 'Could not send email', err);
}
};
module.exports = microfeedback(EmailBackend, {
name: 'email',
version: '1.0.0',
});The service can then be run with the micro CLI via npm start.
{
"name": "microfeedback-email",
"dependencies": {
"micro": "x.y.z",
"microfeedback-core": "x.y.z"
},
"main": "index.js",
"scripts": {
"start": "micro"
}
}npm start
- Fork and clone this repo.
cdinto the project directory. npm install- To run tests:
npm test - To run the example server with auto-reloading:
npm run dev
Add debugger statements, then run the following:
npm install -i iron-node
npm run test:debug
MIT Licensed.