diff --git a/example/hidden.js b/example/hidden.js index b152d93..16e0178 100644 --- a/example/hidden.js +++ b/example/hidden.js @@ -7,13 +7,13 @@ var User = loopback.Model.extend('user', { username: 'string', email: 'string', sensitiveInternalProperty: 'string', -}, {hidden: ['sensitiveInternalProperty']}); +}, { hidden: ['sensitiveInternalProperty'] }); User.attachTo(loopback.memory()); app.model(User); var apiPath = '/api'; -app.use('/explorer', explorer(app, {basePath: apiPath})); +app.use('/explorer', explorer(app, { basePath: apiPath })); app.use(apiPath, loopback.rest()); console.log('Explorer mounted at localhost:' + port + '/explorer'); diff --git a/example/simple.js b/example/simple.js index 70937cd..0ad339c 100644 --- a/example/simple.js +++ b/example/simple.js @@ -4,15 +4,15 @@ var explorer = require('../'); var port = 3000; var Product = loopback.PersistedModel.extend('product', { - foo: {type: 'string', required: true}, + foo: { type: 'string', required: true }, bar: 'string', - aNum: {type: 'number', min: 1, max: 10, required: true, default: 5} + aNum: { type: 'number', min: 1, max: 10, required: true, default: 5 }, }); Product.attachTo(loopback.memory()); app.model(Product); var apiPath = '/api'; -app.use('/explorer', explorer(app, {basePath: apiPath})); +app.use('/explorer', explorer(app, { basePath: apiPath })); app.use(apiPath, loopback.rest()); console.log('Explorer mounted at http://localhost:' + port + '/explorer'); diff --git a/index.js b/index.js index 23b130a..c85c5cd 100644 --- a/index.js +++ b/index.js @@ -2,17 +2,17 @@ /*! * Adds dynamically-updated docs as /explorer */ -var url = require('url'); -var path = require('path'); -var urlJoin = require('./lib/url-join'); -var _defaults = require('lodash').defaults; -var cors = require('cors'); -var createSwaggerObject = require('loopback-swagger').generateSwaggerSpec; -var SWAGGER_UI_ROOT = require('strong-swagger-ui/index').dist; -var STATIC_ROOT = path.join(__dirname, 'public'); + var url = require('url'); + var path = require('path'); + var urlJoin = require('./lib/url-join'); + var _defaults = require('lodash').defaults; + var cors = require('cors'); + var createSwaggerObject = require('loopback-swagger').generateSwaggerSpec; + var SWAGGER_UI_ROOT = require('strong-swagger-ui/index').dist; + var STATIC_ROOT = path.join(__dirname, 'public'); -module.exports = explorer; -explorer.routes = routes; + module.exports = explorer; + explorer.routes = routes; /** * Example usage: @@ -21,34 +21,34 @@ explorer.routes = routes; * explorer(app, options); */ -function explorer(loopbackApplication, options) { - options = _defaults({}, options, { mountPath: '/explorer' }); - loopbackApplication.use(options.mountPath, routes(loopbackApplication, options)); - loopbackApplication.set('loopback-component-explorer', options); -} + function explorer(loopbackApplication, options) { + options = _defaults({}, options, { mountPath: '/explorer' }); + loopbackApplication.use(options.mountPath, routes(loopbackApplication, options)); + loopbackApplication.set('loopback-component-explorer', options); + } -function routes(loopbackApplication, options) { - var loopback = loopbackApplication.loopback; - var loopbackMajor = loopback && loopback.version && + function routes(loopbackApplication, options) { + var loopback = loopbackApplication.loopback; + var loopbackMajor = loopback && loopback.version && loopback.version.split('.')[0] || 1; - if (loopbackMajor < 2) { + if (loopbackMajor < 2) { throw new Error('loopback-component-explorer requires loopback 2.0 or newer'); } - options = _defaults({}, options, { + options = _defaults({}, options, { resourcePath: 'swagger.json', apiInfo: loopbackApplication.get('apiInfo') || {}, - swaggerUI: true + swaggerUI: true, }); - var router = new loopback.Router(); + var router = new loopback.Router(); - mountSwagger(loopbackApplication, router, options); + mountSwagger(loopbackApplication, router, options); // config.json is loaded by swagger-ui. The server should respond // with the relative URI of the resource doc. - router.get('/config.json', function(req, res) { + router.get('/config.json', function(req, res) { // Get the path we're mounted at. It's best to get this from the referer // in case we're proxied at a deep path. var source = url.parse(req.headers.referer || '').pathname; @@ -57,11 +57,11 @@ function routes(loopbackApplication, options) { source = req.originalUrl.replace(/\/config.json(\?.*)?$/, ''); } res.send({ - url: urlJoin(source, '/' + options.resourcePath) + url: urlJoin(source, '/' + options.resourcePath), }); }); - if (options.swaggerUI) { + if (options.swaggerUI) { // Allow specifying a static file roots for swagger files. Any files in // these folders will override those in the swagger-ui distribution. // In this way one could e.g. make changes to index.html without having @@ -83,8 +83,8 @@ function routes(loopbackApplication, options) { router.use(loopback.static(SWAGGER_UI_ROOT)); } - return router; -} + return router; + } /** * Setup Swagger documentation on the given express app. @@ -95,30 +95,30 @@ function routes(loopbackApplication, options) { * swagger documentation. * @param {Object} opts Options. */ -function mountSwagger(loopbackApplication, swaggerApp, opts) { - var swaggerObject = createSwaggerObject(loopbackApplication, opts); + function mountSwagger(loopbackApplication, swaggerApp, opts) { + var swaggerObject = createSwaggerObject(loopbackApplication, opts); // listening to modelRemoted event for updating the swaggerObject // with the newly created model to appear in the Swagger UI. - loopbackApplication.on('modelRemoted', function() { + loopbackApplication.on('modelRemoted', function() { swaggerObject = createSwaggerObject(loopbackApplication, opts); }); - var resourcePath = opts && opts.resourcePath || 'swagger.json'; - if (resourcePath[0] !== '/') resourcePath = '/' + resourcePath; + var resourcePath = opts && opts.resourcePath || 'swagger.json'; + if (resourcePath[0] !== '/') resourcePath = '/' + resourcePath; - var remotes = loopbackApplication.remotes(); - setupCors(swaggerApp, remotes); + var remotes = loopbackApplication.remotes(); + setupCors(swaggerApp, remotes); - swaggerApp.get(resourcePath, function sendSwaggerObject(req, res) { + swaggerApp.get(resourcePath, function sendSwaggerObject(req, res) { res.status(200).send(swaggerObject); }); -} + } -function setupCors(swaggerApp, remotes) { - var corsOptions = remotes.options && remotes.options.cors || + function setupCors(swaggerApp, remotes) { + var corsOptions = remotes.options && remotes.options.cors || { origin: true, credentials: true }; // TODO(bajtos) Skip CORS when remotes.options.cors === false - swaggerApp.use(cors(corsOptions)); -} + swaggerApp.use(cors(corsOptions)); + } diff --git a/public/lib/loadSwaggerUI.js b/public/lib/loadSwaggerUI.js index 2a1a466..b1e34b1 100644 --- a/public/lib/loadSwaggerUI.js +++ b/public/lib/loadSwaggerUI.js @@ -4,7 +4,7 @@ /*global SwaggerUi, log, ApiKeyAuthorization, hljs, window, $ */ $(function() { // Pre load translate... - if(window.SwaggerTranslator) { + if (window.SwaggerTranslator) { window.SwaggerTranslator.translate(); } @@ -28,7 +28,7 @@ $(function() { log(swaggerApi); log(swaggerUi); - if(window.SwaggerTranslator) { + if (window.SwaggerTranslator) { window.SwaggerTranslator.translate(); } @@ -56,7 +56,7 @@ $(function() { return pathCompare !== 0 ? pathCompare : methodOrder.indexOf(a.method) - methodOrder.indexOf(b.method); - } + }, }); $('#explore').click(setAccessToken); @@ -71,7 +71,7 @@ $(function() { e.preventDefault(); var key = $('#input_accessToken')[0].value; log('key: ' + key); - if(key && key.trim() !== '') { + if (key && key.trim() !== '') { log('added accessToken ' + key); var apiKeyAuth = new SwaggerClient.ApiKeyAuthorization('access_token', key, 'query'); window.swaggerUi.api.clientAuthorizations.add('key', apiKeyAuth); diff --git a/test/explorer.test.js b/test/explorer.test.js index c78392c..55de73f 100644 --- a/test/explorer.test.js +++ b/test/explorer.test.js @@ -117,7 +117,7 @@ describe('explorer', function() { beforeEach(function setupExplorerWithUiDirs() { app = loopback(); explorer(app, { - uiDirs: [path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui')] + uiDirs: [path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui')], }); }); @@ -143,7 +143,7 @@ describe('explorer', function() { beforeEach(function setupExplorerWithoutUI() { app = loopback(); explorer(app, { - swaggerUI: false + swaggerUI: false, }); }); @@ -200,7 +200,7 @@ describe('explorer', function() { it('should allow `uiDirs` to be defined as an Array', function(done) { explorer(app, { - uiDirs: [path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui')] + uiDirs: [path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui')], }); request(app).get('/explorer/') @@ -212,7 +212,7 @@ describe('explorer', function() { it('should allow `uiDirs` to be defined as an String', function(done) { explorer(app, { - uiDirs: path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui') + uiDirs: path.resolve(__dirname, 'fixtures', 'dummy-swagger-ui'), }); request(app).get('/explorer/') @@ -238,7 +238,7 @@ describe('explorer', function() { it('can be disabled by configuration', function(done) { var app = loopback(); - app.set('remoting', { cors: { origin: false } }); + app.set('remoting', { cors: { origin: false }}); configureRestApiAndExplorer(app, '/explorer'); request(app)