Merge pull request #620 from CartoDB/gears

Be able to inject custom middlewares

Makefile

@@ -11,7 +11,7 @@ check:
 
 jshint:
 	@echo "***jshint***"
-	@./node_modules/.bin/jshint app/ batch/ test/ app.js
+	@./node_modules/.bin/jshint lib/ test/ app.js
 
 TEST_SUITE := $(shell find test/{unit,integration,acceptance} -name "*.js")
 TEST_SUITE_UNIT := $(shell find test/unit -name "*.js")

app.js

@@ -69,15 +69,10 @@ if (global.settings.log_filename) {
 global.log4js.configure(log4jsConfig);
 global.logger = global.log4js.getLogger();
 
-
-// kick off controller
-if ( ! global.settings.base_url ) {
-    global.settings.base_url = '/api/*';
-}
-
 const version = require("./package").version;
 
-const StatsClient = require('./app/stats/client');
+const StatsClient = require('./lib/stats/client');
+
 if (global.settings.statsd) {
     // Perform keyword substitution in statsd
     if (global.settings.statsd.prefix) {
@@ -86,9 +81,9 @@ if (global.settings.statsd) {
 }
 const statsClient = StatsClient.getInstance(global.settings.statsd);
 
-const serverFactory = require('./app/server');
+const createServer = require('./lib/server');
 
-const server = serverFactory(statsClient);
+const server = createServer(statsClient);
 const listener = server.listen(global.settings.node_port, global.settings.node_host);
 listener.on('listening', function() {
     console.info("Using Node.js %s", process.version);

app/controllers/api-router.js

@@ -1,84 +0,0 @@
-'use strict';
-
-const { Router: router } = require('express');
-
-const UserDatabaseService = require('../services/user_database_service');
-const UserLimitsService = require('../services/user_limits');
-
-const BatchLogger = require('../../batch/batch-logger');
-
-const JobPublisher = require('../../batch/pubsub/job-publisher');
-const JobQueue = require('../../batch/job_queue');
-const JobBackend = require('../../batch/job_backend');
-const JobCanceller = require('../../batch/job_canceller');
-const JobService = require('../../batch/job_service');
-
-const QueryController = require('./query_controller');
-const CopyController = require('./copy_controller');
-const JobController = require('./job_controller');
-
-const socketTimeout = require('../middlewares/socket-timeout');
-const logger = require('../middlewares/logger');
-const profiler = require('../middlewares/profiler');
-const cors = require('../middlewares/cors');
-const servedByHostHeader = require('../middlewares/served-by-host-header');
-
-module.exports = class ApiRouter {
-    constructor ({ redisPool, metadataBackend, statsClient, dataIngestionLogger }) {
-        this.statsClient = statsClient;
-
-        const userLimitsServiceOptions = {
-            limits: {
-                rateLimitsEnabled: global.settings.ratelimits.rateLimitsEnabled
-            }
-        };
-
-        const userDatabaseService = new UserDatabaseService(metadataBackend);
-        const userLimitsService = new UserLimitsService(metadataBackend, userLimitsServiceOptions);
-
-        this.queryController = new QueryController(
-            metadataBackend,
-            userDatabaseService,
-            statsClient,
-            userLimitsService
-        );
-
-        this.copyController = new CopyController(
-            metadataBackend,
-            userDatabaseService,
-            userLimitsService,
-            dataIngestionLogger
-        );
-
-        const logger = new BatchLogger(global.settings.batch_log_filename, 'batch-queries');
-        const jobPublisher = new JobPublisher(redisPool);
-        const jobQueue = new JobQueue(metadataBackend, jobPublisher, logger);
-        const jobBackend = new JobBackend(metadataBackend, jobQueue, logger);
-        const jobCanceller = new JobCanceller();
-        const jobService = new JobService(jobBackend, jobCanceller, logger);
-
-        this.jobController = new JobController(
-            metadataBackend,
-            userDatabaseService,
-            jobService,
-            statsClient,
-            userLimitsService
-        );
-    }
-
-    route (app) {
-        const apiRouter = router({ mergeParams: true });
-
-        apiRouter.use(socketTimeout());
-        apiRouter.use(logger());
-        apiRouter.use(profiler({ statsClient: this.statsClient }));
-        apiRouter.use(cors());
-        apiRouter.use(servedByHostHeader());
-
-        this.queryController.route(apiRouter);
-        this.copyController.route(apiRouter);
-        this.jobController.route(apiRouter);
-
-        app.use(`${global.settings.base_url}`, apiRouter);
-    }
-};

config/environments/development.js.example

@@ -1,9 +1,36 @@
 // Time in milliseconds to force GC cycle.
 // Disable by using <=0 value.
 module.exports.gc_interval = 10000;
-// In case the base_url has a :user param the username will be the one specified in the URL,
-// otherwise it will fallback to extract the username from the host header.
-module.exports.base_url     = '(?:/api/:version|/user/:user/api/:version)';
+module.exports.routes = {
+  // Each entry corresponds with an express' router.
+  // You must define at least one path. However, middlewares are optional.
+  api: [{
+    // Required: path where other "routers" or "controllers" will be attached to.
+    paths: [
+      // In case the path has a :user param the username will be the one specified in the URL,
+      // otherwise it will fallback to extract the username from the host header.
+      '/api/:version',
+      '/user/:user/api/:version',
+    ],
+    // Optional: attach middlewares at the begining of the router
+    // to perform custom operations.
+    middlewares: [
+      function noop () {
+        return function noopMiddleware (req, res, next) {
+            next();
+        }
+      }
+    ],
+    sql: [{
+      // Required
+      paths: [
+        '/sql'
+      ],
+      // Optional
+      middlewares: []
+    }]
+  }]
+};
 // If useProfiler is true every response will be served with an
 // X-SQLAPI-Profile header containing elapsed timing for various
 // steps taken for producing the response.

config/environments/production.js.example

@@ -1,9 +1,36 @@
 // Time in milliseconds to force GC cycle.
 // Disable by using <=0 value.
 module.exports.gc_interval = 10000;
-// In case the base_url has a :user param the username will be the one specified in the URL,
-// otherwise it will fallback to extract the username from the host header.
-module.exports.base_url     = '(?:/api/:version|/user/:user/api/:version)';
+module.exports.routes = {
+  // Each entry corresponds with an express' router.
+  // You must define at least one path. However, middlewares are optional.
+  api: [{
+    // Required: path where other "routers" or "controllers" will be attached to.
+    paths: [
+      // In case the path has a :user param the username will be the one specified in the URL,
+      // otherwise it will fallback to extract the username from the host header.
+      '/api/:version',
+      '/user/:user/api/:version',
+    ],
+    // Optional: attach middlewares at the begining of the router
+    // to perform custom operations.
+    middlewares: [
+      function noop () {
+        return function noopMiddleware (req, res, next) {
+            next();
+        }
+      }
+    ],
+    sql: [{
+      // Required
+      paths: [
+        '/sql'
+      ],
+      // Optional
+      middlewares: []
+    }]
+  }]
+};
 // If useProfiler is true every response will be served with an
 // X-SQLAPI-Profile header containing elapsed timing for various
 // steps taken for producing the response.

config/environments/staging.js.example

@@ -1,9 +1,36 @@
 // Time in milliseconds to force GC cycle.
 // Disable by using <=0 value.
 module.exports.gc_interval = 10000;
-// In case the base_url has a :user param the username will be the one specified in the URL,
-// otherwise it will fallback to extract the username from the host header.
-module.exports.base_url     = '(?:/api/:version|/user/:user/api/:version)';
+module.exports.routes = {
+  // Each entry corresponds with an express' router.
+  // You must define at least one path. However, middlewares are optional.
+  api: [{
+    // Required: path where other "routers" or "controllers" will be attached to.
+    paths: [
+      // In case the path has a :user param the username will be the one specified in the URL,
+      // otherwise it will fallback to extract the username from the host header.
+      '/api/:version',
+      '/user/:user/api/:version',
+    ],
+    // Optional: attach middlewares at the begining of the router
+    // to perform custom operations.
+    middlewares: [
+      function noop () {
+        return function noopMiddleware (req, res, next) {
+            next();
+        }
+      }
+    ],
+    sql: [{
+      // Required
+      paths: [
+        '/sql'
+      ],
+      // Optional
+      middlewares: []
+    }]
+  }]
+};
 // If useProfiler is true every response will be served with an
 // X-SQLAPI-Profile header containing elapsed timing for various
 // steps taken for producing the response.

config/environments/test.js.example

@@ -1,9 +1,36 @@
 // Time in milliseconds to force GC cycle.
 // Disable by using <=0 value.
 module.exports.gc_interval = 10000;
-// In case the base_url has a :user param the username will be the one specified in the URL,
-// otherwise it will fallback to extract the username from the host header.
-module.exports.base_url     = '(?:/api/:version|/user/:user/api/:version)';
+module.exports.routes = {
+  // Each entry corresponds with an express' router.
+  // You must define at least one path. However, middlewares are optional.
+  api: [{
+    // Required: path where other "routers" or "controllers" will be attached to.
+    paths: [
+      // In case the path has a :user param the username will be the one specified in the URL,
+      // otherwise it will fallback to extract the username from the host header.
+      '/api/:version',
+      '/user/:user/api/:version',
+    ],
+    // Optional: attach middlewares at the begining of the router
+    // to perform custom operations.
+    middlewares: [
+      function noop () {
+        return function noopMiddleware (req, res, next) {
+            next();
+        }
+      }
+    ],
+    sql: [{
+      // Required
+      paths: [
+        '/sql'
+      ],
+      // Optional
+      middlewares: []
+    }]
+  }]
+};
 // If useProfiler is true every response will be served with an
 // X-SQLAPI-Profile header containing elapsed timing for various
 // steps taken for producing the response.

lib/api/api-router.js

@@ -0,0 +1,64 @@
+'use strict';
+
+const { Router: router } = require('express');
+
+const SqlRouter = require('./sql/sql-router');
+
+const HealthCheckController = require('./health-check-controller');
+const VersionController = require('./version-controller');
+const JobsWipController = require('./jobs-wip-controller');
+
+const BatchLogger = require('../batch/batch-logger');
+
+const JobPublisher = require('../batch/pubsub/job-publisher');
+const JobQueue = require('../batch/job-queue');
+const JobBackend = require('../batch/job-backend');
+const JobCanceller = require('../batch/job-canceller');
+const JobService = require('../batch/job-service');
+
+module.exports = class ApiRouter {
+    constructor ({ redisPool, metadataBackend, statsClient, dataIngestionLogger }) {
+        const logger = new BatchLogger(global.settings.batch_log_filename, 'batch-queries');
+        const jobPublisher = new JobPublisher(redisPool);
+        const jobQueue = new JobQueue(metadataBackend, jobPublisher, logger);
+        const jobBackend = new JobBackend(metadataBackend, jobQueue, logger);
+        const jobCanceller = new JobCanceller();
+        const jobService = new JobService(jobBackend, jobCanceller, logger);
+
+        this.healthCheckController = new HealthCheckController();
+        this.versionController = new VersionController();
+        this.jobsWipController = new JobsWipController({ jobService });
+
+        this.sqlRouter = new SqlRouter({
+            metadataBackend,
+            statsClient,
+            dataIngestionLogger,
+            jobService
+        });
+    }
+
+    route (app, routes) {
+        routes.forEach(route => {
+            const apiRouter = router({ mergeParams: true });
+
+            const paths = route.paths;
+            const middlewares = route.middlewares || [];
+
+            middlewares.forEach(middleware => apiRouter.use(middleware()));
+
+            // FIXME: version controller should be atached to the main entry point: "/"
+            // instead of "/api/:version" or "/user/:user/api/:version"
+            this.healthCheckController.route(apiRouter);
+
+            // FIXME: version controller should be atached to the main entry point: "/"
+            // instead of "/api/:version" or "/user/:user/api/:version"
+            this.versionController.route(apiRouter);
+
+            this.jobsWipController.route(apiRouter);
+
+            this.sqlRouter.route(apiRouter, route.sql);
+
+            paths.forEach(path => app.use(path, apiRouter));
+        });
+    }
+};

lib/api/health-check-controller.js

@@ -1,14 +1,14 @@
 'use strict';
 
-const HealthCheckBackend = require('../monitoring/health_check');
+const HealthCheckBackend = require('../monitoring/health-check');
 
 module.exports = class HealthCheckController {
     constructor () {
         this.healthCheckBackend = new HealthCheckBackend(global.settings.disabled_file);
     }
 
-    route (app) {
-        app.get(`${global.settings.base_url}/health`, healthCheck({ healthCheckBackend: this.healthCheckBackend }));
+    route (apiRouter) {
+        apiRouter.get('/health', healthCheck({ healthCheckBackend: this.healthCheckBackend }));
     }
 };
 

lib/api/jobs-wip-controller.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const bodyParser = require('./middlewares/body-parser');
+const error = require('./middlewares/error');
+
+module.exports = class JobsWipController {
+    constructor ({ jobService }) {
+        this.jobService = jobService;
+    }
+
+    route (apiRouter) {
+        apiRouter.get('/jobs-wip', [
+            bodyParser(),
+            listWorkInProgressJobs(this.jobService),
+            sendResponse(),
+            error()
+        ]);
+    }
+};
+
+function listWorkInProgressJobs (jobService) {
+    return function listWorkInProgressJobsMiddleware (req, res, next) {
+        jobService.listWorkInProgressJobs((err, list) => {
+            if (err) {
+                return next(err);
+            }
+
+            res.body = list;
+
+            next();
+        });
+    };
+}
+
+function sendResponse () {
+    return function sendResponseMiddleware (req, res) {
+        res.status(res.statusCode || 200).send(res.body);
+    };
+}

lib/api/middlewares/access-validator.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const pgEntitiesAccessValidator = require('../services/pg-entities-access-validator');
+const pgEntitiesAccessValidator = require('../../services/pg-entities-access-validator');
 
 module.exports = function accessValidator () {
     return function accessValidatorMiddleware (req, res, next) {

lib/api/middlewares/authorization.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const AuthApi = require('../auth/auth_api');
+const AuthApi = require('../../auth/auth-api');
 const basicAuth = require('basic-auth');
 
 module.exports = function authorization (metadataBackend, forceToBeMaster = false) {

lib/api/middlewares/content.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const getContentDisposition = require('../utils/content_disposition');
+const getContentDisposition = require('../../utils/content-disposition');
 
 module.exports = function content () {
     return function contentMiddleware (req, res, next) {

lib/api/middlewares/error.js

@@ -1,7 +1,7 @@
 'use strict';
 
-const errorHandlerFactory = require('../services/error_handler_factory');
-const { stringifyForLogs } = require('../utils/logs');
+const errorHandlerFactory = require('../../services/error-handler-factory');
+const { stringifyForLogs } = require('../../utils/logs');
 const MAX_ERROR_STRING_LENGTH = 1024;
 
 module.exports = function error() {

lib/api/middlewares/formatter.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const formats = require('../models/formats');
+const formats = require('../../models/formats');
 
 module.exports =  function formatter () {
     return function formatterMiddleware (req, res, next) {

lib/api/middlewares/log.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { stringifyForLogs } = require('../utils/logs');
+const { stringifyForLogs } = require('../../utils/logs');
 
 const MAX_SQL_LENGTH = (global.settings.logQueries && global.settings.maxQueriesLogLength) || 1024;
 

lib/api/middlewares/params.js

@@ -1,7 +1,7 @@
 'use strict';
 
-const sanitizeFilename = require('../utils/filename_sanitizer');
-const formats = require('../models/formats');
+const sanitizeFilename = require('../../utils/filename-sanitizer');
+const formats = require('../../models/formats');
 
 module.exports = function params ({ strategy = 'query' } = {}) {
     const getParams = getParamsFromStrategy(strategy);

lib/api/middlewares/profiler.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const Profiler = require('../stats/profiler-proxy');
+const Profiler = require('../../stats/profiler-proxy');
 
 module.exports = function profiler ({ statsClient }) {
     return function profilerMiddleware (req, res, next) {
@@ -13,7 +13,7 @@ module.exports = function profiler ({ statsClient }) {
     };
 };
 
-module.exports.initializeProfilerMiddleware = function initializeProfiler (label) {
+module.exports.initializeProfiler = function initializeProfiler (label) {
     return function initializeProfilerMiddleware (req, res, next) {
         if (req.profiler) {
             req.profiler.start(`sqlapi.${label}`);
@@ -23,7 +23,7 @@ module.exports.initializeProfilerMiddleware = function initializeProfiler (label
     };
 };
 
-module.exports.finishProfilerMiddleware = function finishProfiler () {
+module.exports.finishProfiler = function finishProfiler () {
     return function finishProfilerMiddleware (req, res, next) {
         if (req.profiler) {
             req.profiler.end();

lib/api/middlewares/query-may-write.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const queryMayWrite = require('../utils/query_may_write');
+const queryMayWrite = require('../../utils/query-may-write');
 
 module.exports = function mayWrite () {
     return function mayWriteMiddleware (req, res, next) {

lib/api/middlewares/user.js

@@ -1,8 +1,8 @@
 'use strict';
 
-const CdbRequest = require('../models/cartodb_request');
+const CdbRequest = require('../../models/cartodb-request');
 
-module.exports = function user(metadataBackend) {
+module.exports = function user (metadataBackend) {
     const cdbRequest = new CdbRequest();
 
     return function userMiddleware (req, res, next) {
@@ -23,16 +23,16 @@ module.exports = function user(metadataBackend) {
     };
 };
 
-function getUserNameFromRequest(req, cdbRequest) {
+function getUserNameFromRequest (req, cdbRequest) {
     return cdbRequest.userByReq(req);
 }
 
-function checkUserExists(metadataBackend, userName, callback) {
+function checkUserExists (metadataBackend, userName, callback) {
     metadataBackend.getUserId(userName, function(err) {
         callback(err, !err);
     });
 }
 
-function errorUserNotFoundMessageTemplate(user) {
+function errorUserNotFoundMessageTemplate (user) {
     return `Sorry, we can't find CARTO user '${user}'. Please check that you have entered the correct domain.`;
 }

lib/api/sql/copy-controller.js

@@ -1,21 +1,21 @@
 'use strict';
 
-const userMiddleware = require('../middlewares/user');
-const errorMiddleware = require('../middlewares/error');
-const authorizationMiddleware = require('../middlewares/authorization');
-const connectionParamsMiddleware = require('../middlewares/connection-params');
-const { initializeProfilerMiddleware } = require('../middlewares/profiler');
-const rateLimitsMiddleware = require('../middlewares/rate-limit');
-const dbQuotaMiddleware = require('../middlewares/db-quota');
-const { RATE_LIMIT_ENDPOINTS_GROUPS } = rateLimitsMiddleware;
-const errorHandlerFactory = require('../services/error_handler_factory');
-const StreamCopy = require('../services/stream_copy');
-const StreamCopyMetrics = require('../services/stream_copy_metrics');
-const Throttler = require('../services/throttler-stream');
+const user = require('../middlewares/user');
+const error = require('../middlewares/error');
+const authorization = require('../middlewares/authorization');
+const connectionParams = require('../middlewares/connection-params');
+const { initializeProfiler } = require('../middlewares/profiler');
+const dbQuota = require('../middlewares/db-quota');
+const bodyParser = require('../middlewares/body-parser');
+const rateLimits = require('../middlewares/rate-limit');
+const { RATE_LIMIT_ENDPOINTS_GROUPS } = rateLimits;
+const errorHandlerFactory = require('../../services/error-handler-factory');
+const StreamCopy = require('../../services/stream-copy');
+const StreamCopyMetrics = require('../../services/stream-copy-metrics');
+const Throttler = require('../../services/throttler-stream');
 const zlib = require('zlib');
 const { PassThrough } = require('stream');
 const params = require('../middlewares/params');
-const bodyParserMiddleware = require('../middlewares/body-parser');
 
 module.exports = class CopyController {
     constructor (metadataBackend, userDatabaseService, userLimitsService, logger) {
@@ -25,40 +25,40 @@ module.exports = class CopyController {
         this.logger = logger;
     }
 
-    route (apiRouter) {
+    route (sqlRouter) {
         const copyFromMiddlewares = endpointGroup => {
             return [
-                initializeProfilerMiddleware('copyfrom'),
-                userMiddleware(this.metadataBackend),
-                rateLimitsMiddleware(this.userLimitsService, endpointGroup),
-                authorizationMiddleware(this.metadataBackend),
-                connectionParamsMiddleware(this.userDatabaseService),
-                dbQuotaMiddleware(),
+                initializeProfiler('copyfrom'),
+                user(this.metadataBackend),
+                rateLimits(this.userLimitsService, endpointGroup),
+                authorization(this.metadataBackend),
+                connectionParams(this.userDatabaseService),
+                dbQuota(),
                 params({ strategy: 'copyfrom' }),
                 handleCopyFrom(this.logger),
                 errorHandler(this.logger),
-                errorMiddleware()
+                error()
             ];
         };
 
         const copyToMiddlewares = endpointGroup => {
             return [
-                bodyParserMiddleware(),
-                initializeProfilerMiddleware('copyto'),
-                userMiddleware(this.metadataBackend),
-                rateLimitsMiddleware(this.userLimitsService, endpointGroup),
-                authorizationMiddleware(this.metadataBackend),
-                connectionParamsMiddleware(this.userDatabaseService),
+                bodyParser(),
+                initializeProfiler('copyto'),
+                user(this.metadataBackend),
+                rateLimits(this.userLimitsService, endpointGroup),
+                authorization(this.metadataBackend),
+                connectionParams(this.userDatabaseService),
                 params({ strategy: 'copyto' }),
                 handleCopyTo(this.logger),
                 errorHandler(this.logger),
-                errorMiddleware()
+                error()
             ];
         };
 
-        apiRouter.post('/sql/copyfrom', copyFromMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_FROM));
-        apiRouter.get('/sql/copyto', copyToMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_TO));
-        apiRouter.post('/sql/copyto', copyToMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_TO));
+        sqlRouter.post('/copyfrom', copyFromMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_FROM));
+        sqlRouter.get('/copyto', copyToMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_TO));
+        sqlRouter.post('/copyto', copyToMiddlewares(RATE_LIMIT_ENDPOINTS_GROUPS.COPY_TO));
     }
 };
 

lib/api/sql/job-controller.js

@@ -2,16 +2,16 @@
 
 const util = require('util');
 
-const bodyParserMiddleware = require('../middlewares/body-parser');
-const userMiddleware = require('../middlewares/user');
-const { initializeProfilerMiddleware, finishProfilerMiddleware } = require('../middlewares/profiler');
-const authorizationMiddleware = require('../middlewares/authorization');
-const connectionParamsMiddleware = require('../middlewares/connection-params');
-const errorMiddleware = require('../middlewares/error');
-const rateLimitsMiddleware = require('../middlewares/rate-limit');
-const { RATE_LIMIT_ENDPOINTS_GROUPS } = rateLimitsMiddleware;
+const bodyParser = require('../middlewares/body-parser');
+const user = require('../middlewares/user');
+const { initializeProfiler, finishProfiler } = require('../middlewares/profiler');
+const authorization = require('../middlewares/authorization');
+const connectionParams = require('../middlewares/connection-params');
+const error = require('../middlewares/error');
+const rateLimits = require('../middlewares/rate-limit');
+const { RATE_LIMIT_ENDPOINTS_GROUPS } = rateLimits;
 const params = require('../middlewares/params');
-const logMiddleware = require('../middlewares/log');
+const log = require('../middlewares/log');
 
 module.exports = class JobController {
     constructor (metadataBackend, userDatabaseService, jobService, statsdClient, userLimitsService) {
@@ -22,7 +22,7 @@ module.exports = class JobController {
         this.userLimitsService = userLimitsService;
     }
 
-    route (apiRouter) {
+    route (sqlRouter) {
         const jobMiddlewares = composeJobMiddlewares(
             this.metadataBackend,
             this.userDatabaseService,
@@ -31,55 +31,44 @@ module.exports = class JobController {
             this.userLimitsService
         );
 
-        apiRouter.get(
-            '/jobs-wip',
-            bodyParserMiddleware(),
-            listWorkInProgressJobs(this.jobService),
-            sendResponse(),
-            errorMiddleware()
-        );
-
-        apiRouter.post(
-            '/sql/job',
-            bodyParserMiddleware(),
+        sqlRouter.post('/job', [
+            bodyParser(),
             checkBodyPayloadSize(),
             params({ strategy: 'job' }),
-            logMiddleware(logMiddleware.TYPES.JOB),
+            log(log.TYPES.JOB),
             jobMiddlewares('create', createJob, RATE_LIMIT_ENDPOINTS_GROUPS.JOB_CREATE)
-        );
+        ]);
 
-        apiRouter.get(
-            '/sql/job/:job_id',
-            bodyParserMiddleware(),
+        sqlRouter.get('/job/:job_id', [
+            bodyParser(),
             jobMiddlewares('retrieve', getJob, RATE_LIMIT_ENDPOINTS_GROUPS.JOB_GET)
-        );
+        ]);
 
-        apiRouter.delete(
-            '/sql/job/:job_id',
-            bodyParserMiddleware(),
+        sqlRouter.delete('/job/:job_id', [
+            bodyParser(),
             jobMiddlewares('cancel', cancelJob, RATE_LIMIT_ENDPOINTS_GROUPS.JOB_DELETE)
-        );
+        ]);
     }
 };
 
 function composeJobMiddlewares (metadataBackend, userDatabaseService, jobService, statsdClient, userLimitsService) {
-    return function jobMiddlewares (action, jobMiddleware, endpointGroup) {
+    return function jobMiddlewares (action, job, endpointGroup) {
         const forceToBeMaster = true;
 
         return [
-            initializeProfilerMiddleware('job'),
-            userMiddleware(metadataBackend),
-            rateLimitsMiddleware(userLimitsService, endpointGroup),
-            authorizationMiddleware(metadataBackend, forceToBeMaster),
-            connectionParamsMiddleware(userDatabaseService),
-            jobMiddleware(jobService),
+            initializeProfiler('job'),
+            user(metadataBackend),
+            rateLimits(userLimitsService, endpointGroup),
+            authorization(metadataBackend, forceToBeMaster),
+            connectionParams(userDatabaseService),
+            job(jobService),
             setServedByDBHostHeader(),
-            finishProfilerMiddleware(),
+            finishProfiler(),
             logJobResult(action),
             incrementSuccessMetrics(statsdClient),
             sendResponse(),
             incrementErrorMetrics(statsdClient),
-            errorMiddleware()
+            error()
         ];
     };
 }
@@ -155,21 +144,6 @@ function createJob (jobService) {
     };
 }
 
-function listWorkInProgressJobs (jobService) {
-    return function listWorkInProgressJobsMiddleware (req, res, next) {
-        jobService.listWorkInProgressJobs((err, list) => {
-            if (err) {
-                return next(err);
-            }
-
-            res.body = list;
-
-            next();
-        });
-    };
-}
-
-
 function checkBodyPayloadSize () {
     return function checkBodyPayloadSizeMiddleware(req, res, next) {
         const payload = JSON.stringify(req.body);

lib/api/sql/query-controller.js

@@ -1,7 +1,7 @@
 'use strict';
 
 const bodyParser = require('../middlewares/body-parser');
-const { initializeProfilerMiddleware: initializeProfiler } = require('../middlewares/profiler');
+const { initializeProfiler } = require('../middlewares/profiler');
 const user = require('../middlewares/user');
 const rateLimits = require('../middlewares/rate-limit');
 const authorization = require('../middlewares/authorization');
@@ -32,7 +32,7 @@ module.exports = class QueryController {
         this.userLimitsService = userLimitsService;
     }
 
-    route (apiRouter) {
+    route (sqlRouter) {
         const forceToBeMaster = false;
 
         const queryMiddlewares = () => {
@@ -61,8 +61,8 @@ module.exports = class QueryController {
             ];
         };
 
-        apiRouter.all('/sql', queryMiddlewares());
-        apiRouter.all('/sql.:f', queryMiddlewares());
+        sqlRouter.all('/', queryMiddlewares());
+        sqlRouter.all('.:f', queryMiddlewares());
     }
 };
 

lib/api/sql/sql-router.js

@@ -0,0 +1,73 @@
+'use strict';
+
+const { Router: router } = require('express');
+
+const UserDatabaseService = require('../../services/user-database-service');
+const UserLimitsService = require('../../services/user-limits');
+
+const socketTimeout = require('../middlewares/socket-timeout');
+const logger = require('../middlewares/logger');
+const profiler = require('../middlewares/profiler');
+const cors = require('../middlewares/cors');
+const servedByHostHeader = require('../middlewares/served-by-host-header');
+
+const QueryController = require('./query-controller');
+const CopyController = require('./copy-controller');
+const JobController = require('./job-controller');
+
+module.exports = class SqlRouter {
+    constructor ({ metadataBackend, statsClient, dataIngestionLogger, jobService }) {
+        const userLimitsServiceOptions = {
+            limits: {
+                rateLimitsEnabled: global.settings.ratelimits.rateLimitsEnabled
+            }
+        };
+        const userDatabaseService = new UserDatabaseService(metadataBackend);
+        const userLimitsService = new UserLimitsService(metadataBackend, userLimitsServiceOptions);
+
+        this.queryController = new QueryController(
+            metadataBackend,
+            userDatabaseService,
+            statsClient,
+            userLimitsService
+        );
+
+        this.copyController = new CopyController(
+            metadataBackend,
+            userDatabaseService,
+            userLimitsService,
+            dataIngestionLogger
+        );
+
+        this.jobController = new JobController(
+            metadataBackend,
+            userDatabaseService,
+            jobService,
+            statsClient,
+            userLimitsService
+        );
+    }
+
+    route (apiRouter, routes) {
+        routes.forEach(route => {
+            const sqlRouter = router({ mergeParams: true });
+
+            const paths = route.paths;
+            const middlewares = route.middlewares || [];
+
+            middlewares.forEach(middleware => sqlRouter.use(middleware()));
+
+            sqlRouter.use(socketTimeout());
+            sqlRouter.use(logger());
+            sqlRouter.use(profiler({ statsClient: this.statsClient }));
+            sqlRouter.use(cors());
+            sqlRouter.use(servedByHostHeader());
+
+            this.queryController.route(sqlRouter);
+            this.copyController.route(sqlRouter);
+            this.jobController.route(sqlRouter);
+
+            paths.forEach(path => apiRouter.use(path, sqlRouter));
+        });
+    }
+};

lib/api/version-controller.js

@@ -5,8 +5,8 @@ const versions = {
 };
 
 module.exports = class VersionController {
-    route (app) {
-        app.get(`${global.settings.base_url}/version`, version());
+    route (apiRouter) {
+        apiRouter.get('/version', version());
     }
 };
 

lib/auth/oauth.js

@@ -4,7 +4,7 @@
 var _ = require('underscore');
 var OAuthUtil = require('oauth-client');
 var step = require('step');
-var CdbRequest = require('../models/cartodb_request');
+var CdbRequest = require('../models/cartodb-request');
 var cdbReq = new CdbRequest();
 
 var oAuth = (function(){

lib/batch/batch-logger.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const Logger = require('../app/services/logger');
+const Logger = require('../services/logger');
 
 class BatchLogger extends Logger {
     constructor (path, name) {
@@ -10,7 +10,6 @@ class BatchLogger extends Logger {
     log (job) {
         return job.log(this.logger);
     }
-
 }
 
 module.exports = BatchLogger;

lib/batch/index.js

@@ -1,14 +1,14 @@
 'use strict';
 
-var JobRunner = require('./job_runner');
-var QueryRunner = require('./query_runner');
-var JobCanceller = require('./job_canceller');
+var JobRunner = require('./job-runner');
+var QueryRunner = require('./query-runner');
+var JobCanceller = require('./job-canceller');
 var JobSubscriber = require('./pubsub/job-subscriber');
-var UserDatabaseMetadataService = require('./user_database_metadata_service');
+var UserDatabaseMetadataService = require('./user-database-metadata-service');
 var JobPublisher = require('./pubsub/job-publisher');
-var JobQueue = require('./job_queue');
-var JobBackend = require('./job_backend');
-var JobService = require('./job_service');
+var JobQueue = require('./job-queue');
+var JobBackend = require('./job-backend');
+var JobService = require('./job-service');
 var BatchLogger = require('./batch-logger');
 var Batch = require('./batch');
 

lib/batch/job-backend.js

@@ -2,7 +2,7 @@
 
 var REDIS_PREFIX = 'batch:jobs:';
 var REDIS_DB = 5;
-var JobStatus = require('./job_status');
+var JobStatus = require('./job-status');
 var queue = require('queue-async');
 
 function JobBackend(metadataBackend, jobQueue, logger) {

lib/batch/job-runner.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var errorCodes = require('../app/postgresql/error_codes').codeToCondition;
-var jobStatus = require('./job_status');
+var errorCodes = require('../postgresql/error-codes').codeToCondition;
+var jobStatus = require('./job-status');
 var Profiler = require('step-profiler');
 var _ = require('underscore');
 

lib/batch/job-service.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var JobFactory = require('./models/job_factory');
-var jobStatus = require('./job_status');
+var JobFactory = require('./models/job-factory');
+var jobStatus = require('./job-status');
 
 function JobService(jobBackend, jobCanceller, logger) {
     this.jobBackend = jobBackend;

lib/batch/models/job-base.js

@@ -2,8 +2,8 @@
 
 var util = require('util');
 var uuid = require('node-uuid');
-var JobStateMachine = require('./job_state_machine');
-var jobStatus = require('../job_status');
+var JobStateMachine = require('./job-state-machine');
+var jobStatus = require('../job-status');
 var mandatoryProperties = [
     'job_id',
     'status',

lib/batch/models/job-factory.js

@@ -1,8 +1,8 @@
 'use strict';
 
-var JobSimple = require('./job_simple');
-var JobMultiple = require('./job_multiple');
-var JobFallback = require('./job_fallback');
+var JobSimple = require('./job-simple');
+var JobMultiple = require('./job-multiple');
+var JobFallback = require('./job-fallback');
 
 var Models = [ JobSimple, JobMultiple, JobFallback ];
 

lib/batch/models/job-fallback.js

@@ -1,11 +1,11 @@
 'use strict';
 
 var util = require('util');
-var JobBase = require('./job_base');
-var JobStatus = require('../job_status');
-var QueryFallback = require('./query/query_fallback');
-var MainFallback = require('./query/main_fallback');
-var QueryFactory = require('./query/query_factory');
+var JobBase = require('./job-base');
+var JobStatus = require('../job-status');
+var QueryFallback = require('./query/query-fallback');
+var MainFallback = require('./query/main-fallback');
+var QueryFactory = require('./query/query-factory');
 
 function JobFallback(jobDefinition) {
     JobBase.call(this, jobDefinition);

lib/batch/models/job-multiple.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var util = require('util');
-var JobBase = require('./job_base');
-var jobStatus = require('../job_status');
+var JobBase = require('./job-base');
+var jobStatus = require('../job-status');
 
 function JobMultiple(jobDefinition) {
     JobBase.call(this, jobDefinition);

lib/batch/models/job-simple.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var util = require('util');
-var JobBase = require('./job_base');
-var jobStatus = require('../job_status');
+var JobBase = require('./job-base');
+var jobStatus = require('../job-status');
 
 function JobSimple(jobDefinition) {
     JobBase.call(this, jobDefinition);

lib/batch/models/job-state-machine.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var assert = require('assert');
-var JobStatus = require('../job_status');
+var JobStatus = require('../job-status');
 var validStatusTransitions = [
     [JobStatus.PENDING, JobStatus.RUNNING],
     [JobStatus.PENDING, JobStatus.CANCELLED],

lib/batch/models/query/fallback.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var util = require('util');
-var QueryBase = require('./query_base');
-var jobStatus = require('../../job_status');
+var QueryBase = require('./query-base');
+var jobStatus = require('../../job-status');
 
 function Fallback(index) {
     QueryBase.call(this, index);

lib/batch/models/query/main-fallback.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var util = require('util');
-var QueryBase = require('./query_base');
-var jobStatus = require('../../job_status');
+var QueryBase = require('./query-base');
+var jobStatus = require('../../job-status');
 
 function MainFallback() {
     QueryBase.call(this);

lib/batch/models/query/query-base.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var util = require('util');
-var JobStateMachine = require('../job_state_machine');
+var JobStateMachine = require('../job-state-machine');
 
 function QueryBase(index) {
     JobStateMachine.call(this);

lib/batch/models/query/query-factory.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var QueryFallback = require('./query_fallback');
+var QueryFallback = require('./query-fallback');
 
 function QueryFactory() {
 }

lib/batch/models/query/query-fallback.js

@@ -1,10 +1,10 @@
 'use strict';
 
 var util = require('util');
-var QueryBase = require('./query_base');
+var QueryBase = require('./query-base');
 var Query = require('./query');
 var Fallback = require('./fallback');
-var jobStatus = require('../../job_status');
+var jobStatus = require('../../job-status');
 
 function QueryFallback(job, index) {
     QueryBase.call(this, index);

lib/batch/models/query/query.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var util = require('util');
-var QueryBase = require('./query_base');
-var jobStatus = require('../../job_status');
+var QueryBase = require('./query-base');
+var jobStatus = require('../../job-status');
 
 function Query(index) {
     QueryBase.call(this, index);

lib/models/formats/pg/arraybuffer.js

@@ -3,7 +3,7 @@
 var _ = require('underscore');
 
 var Pg  = require('./../pg');
-var ArrayBufferSer = require("../../bin_encoder");
+var ArrayBufferSer = require("../../bin-encoder");
 
 function BinaryFormat() {}
 

lib/models/formats/pg/geojson.js

@@ -2,8 +2,8 @@
 
 var _ = require('underscore');
 
-var Pg  = require('./../pg');
-const errorHandlerFactory = require('../../../services/error_handler_factory');
+var Pg = require('./../pg');
+const errorHandlerFactory = require('../../../services/error-handler-factory');
 
 function GeoJsonFormat() {
     this.buffer = '';

lib/models/formats/pg/json.js

@@ -3,7 +3,7 @@
 var _ = require('underscore');
 
 var Pg  = require('./../pg');
-const errorHandlerFactory = require('../../../services/error_handler_factory');
+const errorHandlerFactory = require('../../../services/error-handler-factory');
 
 function JsonFormat() {
     this.buffer = '';

lib/models/formats/pg/topojson.js

@@ -1,5 +1,7 @@
 'use strict';
 
+// jshint ignore:start
+
 var Pg  = require('./../pg');
 var _ = require('underscore');
 var geojson = require('./geojson');
@@ -133,6 +135,6 @@ TopoJsonFormat.prototype.cancel = function() {
     }
 };
 
-
-
 module.exports = TopoJsonFormat;
+
+// jshint ignore:end

lib/server-options.js

@@ -0,0 +1,32 @@
+'use strict';
+
+module.exports = function getServerOptions () {
+    const defaults = {
+        routes: {
+            // Each entry corresponds with an express' router.
+            // You must define at least one path. However, middlewares are optional.
+            api: [{
+                // Required: path where other "routers" or "controllers" will be attached to.
+                paths: [
+                    // In case the path has a :user param the username will be the one specified in the URL,
+                    // otherwise it will fallback to extract the username from the host header.
+                    '/api/:version',
+                    '/user/:user/api/:version',
+                ],
+                // Optional: attach middlewares at the begining of the router
+                // to perform custom operations.
+                middlewares: [],
+                sql: [{
+                    // Required
+                    paths: [
+                        '/sql'
+                    ],
+                    // Optional
+                    middlewares: []
+                }]
+            }]
+        }
+    };
+
+    return Object.assign({}, defaults, global.settings);
+};