added API for retrieving queues

lib/routes/api/accounts.js

@@ -9,8 +9,11 @@ const uuidv4 = require('uuid/v4');
 const snakeCase = require('../../utils/snake-case');
 const sysError = require('./error');
 const {promisePool} = require('../../db');
+const {hasAccountPermissions} = require('./utils');
 let idx = 0;
 
+router.use('/:sid/Queues', hasAccountPermissions, require('./queues'));
+
 function coerceNumbers(callInfo) {
   if (Array.isArray(callInfo)) {
     return callInfo.map((ci) => {

lib/routes/api/queues.js

@@ -0,0 +1,20 @@
+const router = require('express').Router();
+const sysError = require('./error');
+const {parseAccountSid} = require('./utils');
+
+/**
+ * retrieve queues for an account
+ */
+router.get('/', async(req, res) => {
+  const account_sid = parseAccountSid(req);
+  const {logger, listQueues} = req.app.locals;
+  try {
+    const queues = await listQueues(account_sid, req.query.name);
+    res.status(200).json(queues);
+  } catch (err) {
+    sysError(logger, res, err);
+  }
+});
+
+
+module.exports = router;

lib/routes/api/utils.js

@@ -0,0 +1,40 @@
+const parseServiceProviderSid = (req) => {
+  const arr = /ServiceProviders\/([^\/]*)/.exec(req.originalUrl);
+  if (arr) return arr[1];
+};
+
+const parseAccountSid = (req) => {
+  const arr = /Accounts\/([^\/]*)/.exec(req.originalUrl);
+  if (arr) return arr[1];
+};
+
+const hasAccountPermissions = (req, res, next) => {
+  if (req.user.hasScope('admin')) return next();
+  if (req.user.hasScope('account')) {
+    const account_sid = parseAccountSid(req);
+    if (account_sid === req.user.account_sid) return next();
+  }
+  res.status(403).json({
+    status: 'fail',
+    message: 'insufficient privileges'
+  });
+};
+
+const hasServiceProviderPermissions = (req, res, next) => {
+  if (req.user.hasScope('admin')) return next();
+  if (req.user.hasScope('service_provider')) {
+    const service_provider_sid = parseServiceProviderSid(req);
+    if (service_provider_sid === req.user.service_provider_sid) return next();
+  }
+  res.status(403).json({
+    status: 'fail',
+    message: 'insufficient privileges'
+  });
+};
+
+module.exports = {
+  parseAccountSid,
+  parseServiceProviderSid,
+  hasAccountPermissions,
+  hasServiceProviderPermissions
+};

lib/swagger/swagger.yaml

@@ -1402,7 +1402,37 @@ paths:
               schema:
                 $ref: '#/components/schemas/GeneralError'
         
-  
+  /Accounts/{AccountSid}/Queues:
+    get:
+      summary: list queues for an Account
+      parameters:
+      - name: AccountSid
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: 
+        - in: query
+          name: name
+          required: false
+          schema:
+            type: string
+            description: a queue name or glob-style pattern matching one or more queues to return
+      responses:
+        200:
+          description: list of queues for this account matching the name query param, if provided
+          application/json:
+            schema:
+              type: array
+              items:
+                $ref: '#/components/schemas/Queue'
+        500:
+          description: system error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GeneralError'
+
   /Accounts/{AccountSid}/Calls:
     post:
       summary: create a call
@@ -1989,6 +2019,18 @@ components:
         - from
         - to
       example: {"from": "13394445678", "to": "16173333456", "text": "please call when you can"}
-
+    Queue:
+      properties:
+        name:
+          type: string
+          example: support
+        length:
+          type: number
+          format: integer
+          example: 5
+      required:
+        - name
+        - length
+      example: {"name": "new-orders", length: 12}
 security:
   - bearerAuth: []