'use strict'; var routeHelper = require('../lib/route-helper'); var expect = require('chai').expect; var _defaults = require('lodash.defaults'); describe('route-helper', function() { it('returns "object" when a route has multiple return values', function() { var doc = createAPIDoc({ returns: [ { arg: 'max', type: 'number' }, { arg: 'min', type: 'number' }, { arg: 'avg', type: 'number' } ] }); expect(doc.operations[0].type).to.equal(undefined); expect(getResponseType(doc.operations[0])).to.equal('object'); }); it('converts path params when they exist in the route name', function() { var doc = createAPIDoc({ accepts: [ {arg: 'id', type: 'string'} ], path: '/test/:id' }); var paramDoc = doc.operations[0].parameters[0]; expect(paramDoc.paramType).to.equal('path'); expect(paramDoc.name).to.equal('id'); expect(paramDoc.required).to.equal(false); }); // FIXME need regex in routeHelper.acceptToParameter xit('won\'t convert path params when they don\'t exist in the route name', function() { var doc = createAPIDoc({ accepts: [ {arg: 'id', type: 'string'} ], path: '/test/:identifier' }); var paramDoc = doc.operations[0].parameters[0]; expect(paramDoc.paramType).to.equal('query'); }); it('correctly coerces param types', function() { var doc = createAPIDoc({ accepts: [ {arg: 'binaryData', type: 'buffer'} ] }); var paramDoc = doc.operations[0].parameters[0]; expect(paramDoc.paramType).to.equal('query'); expect(paramDoc.type).to.equal('string'); expect(paramDoc.format).to.equal('byte'); }); it('correctly converts return types (arrays)', function() { var doc = createAPIDoc({ returns: [ {arg: 'data', type: ['customType']} ] }); var opDoc = doc.operations[0]; // Note: swagger-ui treat arrays of X the same way as object X expect(getResponseType(opDoc)).to.equal('customType'); // NOTE(bajtos) this would be the case if there was a single response type // expect(opDoc.type).to.equal('array'); // expect(opDoc.items).to.eql({type: 'customType'}); }); it('includes `notes` metadata', function() { var doc = createAPIDoc({ notes: 'some notes' }); expect(doc.operations[0].notes).to.equal('some notes'); }); it('includes `deprecated` metadata', function() { var doc = createAPIDoc({ deprecated: 'true' }); expect(doc.operations[0].deprecated).to.equal('true'); }); it('joins array description/summary', function() { var doc = createAPIDoc({ description: [ 'line1', 'line2' ] }); expect(doc.operations[0].summary).to.equal('line1\nline2'); }); it('joins array notes', function() { var doc = createAPIDoc({ notes: [ 'line1', 'line2' ] }); expect(doc.operations[0].notes).to.equal('line1\nline2'); }); it('joins array description/summary of an input arg', function() { var doc = createAPIDoc({ accepts: [{ name: 'arg', description: [ 'line1', 'line2' ] }] }); expect(doc.operations[0].parameters[0].description).to.equal('line1\nline2'); }); it('correctly does not include context params', function() { var doc = createAPIDoc({ accepts: [ {arg: 'ctx', http: {source: 'context'}} ], path: '/test' }); var params = doc.operations[0].parameters; expect(params.length).to.equal(0); }); it('correctly does not include request params', function() { var doc = createAPIDoc({ accepts: [ {arg: 'req', http: {source: 'req'}} ], path: '/test' }); var params = doc.operations[0].parameters; expect(params.length).to.equal(0); }); it('correctly does not include response params', function() { var doc = createAPIDoc({ accepts: [ {arg: 'res', http: {source: 'res'}} ], path: '/test' }); var params = doc.operations[0].parameters; expect(params.length).to.equal(0); }); it('preserves `enum` accepts arg metadata', function() { var doc = createAPIDoc({ accepts: [{ name: 'arg', type: 'number', enum: [1,2,3] }] }); expect(doc.operations[0].parameters[0]) .to.have.property('enum').eql([1,2,3]); }); it('includes the default response message with code 200', function() { var doc = createAPIDoc({ returns: [{ name: 'result', type: 'object', root: true }] }); expect(doc.operations[0].responseMessages).to.eql([ { code: 200, message: 'Request was successful', responseModel: 'object' } ]); }); it('uses the response code 204 when `returns` is empty', function() { var doc = createAPIDoc({ returns: [] }); expect(doc.operations[0].responseMessages).to.eql([ { code: 204, message: 'Request was successful', responseModel: 'void' } ]); }); it('includes custom error response in `responseMessages`', function() { var doc = createAPIDoc({ errors: [{ code: 422, message: 'Validation failed', responseModel: 'ValidationError' }] }); expect(doc.operations[0].responseMessages[1]).to.eql({ code: 422, message: 'Validation failed', responseModel: 'ValidationError' }); }); it('route nickname does not include model name.', function() { var doc = createAPIDoc(); expect(doc.operations[0].nickname).to.equal('get'); }); it('route nickname with a period is shorted correctly', function() { // Method is built by remoting to always be #{className}.#{methodName} var doc = createAPIDoc({ method: 'test.get.me' }); expect(doc.operations[0].nickname).to.eql('get.me'); }); }); // Easy wrapper around createRoute function createAPIDoc(def) { return routeHelper.routeToAPIDoc(_defaults(def || {}, { path: '/test', verb: 'GET', method: 'test.get' })); } function getResponseType(operationDoc) { return operationDoc.responseMessages[0].responseModel; }