initial support for conference and queues

lib/http-routes/api/conference.js

@@ -0,0 +1,41 @@
+const router = require('express').Router();
+const sysError = require('./error');
+const sessionTracker = require('../../session/session-tracker');
+const {TaskName} = require('../../utils/constants.json');
+const {DbErrorUnprocessableRequest} = require('../utils/errors');
+
+/**
+ * validate the call state
+ */
+function retrieveCallSession(callSid, opts) {
+  const cs = sessionTracker.get(callSid);
+  if (cs) {
+    const task = cs.currentTask;
+    if (!task || task.name != TaskName.Conference) {
+      throw new DbErrorUnprocessableRequest(`conference api failure: indicated call is not waiting: ${task.name}`);
+    }
+  }
+  return cs;
+}
+
+/**
+ * notify a waiting session that a conference has started
+ */
+router.post('/:callSid', async(req, res) => {
+  const logger = req.app.locals.logger;
+  const callSid = req.params.callSid;
+  logger.debug({body: req.body}, 'got conference request');
+  try {
+    const cs = retrieveCallSession(callSid, req.body);
+    if (!cs) {
+      logger.info(`conference: callSid not found ${callSid}`);
+      return res.sendStatus(404);
+    }
+    res.status(202).end();
+    cs.notifyConferenceEvent(req.body);
+  } catch (err) {
+    sysError(logger, res, err);
+  }
+});
+
+module.exports = router;