nexmo-oas-renderer 2.1.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91aab3edd9be633271fd990e068b50382b9084e487c7cfd305fe02f0ac47158b
-  data.tar.gz: e5fb1777e48e43054d461fceabdf0ce7786211303fcf468e5e8057e6ebaaa1db
+  metadata.gz: 016a49c9888907ebeabf72eec4ac343c5640ed75ae30e25c26ec8db60d635b15
+  data.tar.gz: 848b18e42b84eb80fbd32f58f07884800fcb377fc81cac9c4c46a023bdf112fe
 SHA512:
-  metadata.gz: 8077595864ec381244b429efdcb6b87013d469d8f1c69ef81c83ba5d3891274259150ee8cec94c8b66a249ab301dff2c7e73d951da85f70f766983867fd7d93d
-  data.tar.gz: 14bd51335bbb81fbe9a3d7c11ffbb234eafda74e11f3436bf280a51996d8e1deb3536561f40cbb207586cb6c1bd1ed9da3585f57ea07df10b8a899c6203a0420
+  metadata.gz: ec4dbcdd04b93935e0edfc7d83d25aaceefd03a96ca57bc93307c2d46ece8c808311ed0d5d5b3dbada11e919d8b6089dd1dd9ee08d03d1918900d6097c8fff1a
+  data.tar.gz: e2d8cc466dc06b928e6a79477b4e9eb65ff628b14cb8b348e4f08fd3d5118a978ed334a1d70b5668eeb39207c6d70003a499fff7aaaecef826cbfeb88f59b29f

data/.github/workflows/pull_request-review.yml

@@ -0,0 +1,14 @@
+name: Review App
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize, labeled, closed]
+jobs:
+  create-review-app:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create Review App
+        uses: mheap/github-action-pr-heroku-review-app@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HEROKU_PIPELINE_ID: ${{ secrets.HEROKU_PIPELINE_ID }}
+          HEROKU_API_TOKEN: ${{ secrets.HEROKU_API_TOKEN }}

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+# 2.2.0
+* Add error list to API reference
+
 # 0.11.3
 * Change oas url constructor to be entire config parameter and not only partial
 * Bump websocket-extensions, fixes CVE-2020-7663

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nexmo-oas-renderer (2.1.1)
+    nexmo-oas-renderer (2.3.0)
       activemodel (~> 6.0)
       activesupport (~> 6.0)
       banzai (~> 0.1.2)
@@ -18,56 +18,56 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (6.0.3.2)
-      actionpack (= 6.0.3.2)
+    actioncable (6.0.3.4)
+      actionpack (= 6.0.3.4)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      activejob (= 6.0.3.2)
-      activerecord (= 6.0.3.2)
-      activestorage (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
+    actionmailbox (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activejob (= 6.0.3.4)
+      activerecord (= 6.0.3.4)
+      activestorage (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       mail (>= 2.7.1)
-    actionmailer (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      actionview (= 6.0.3.2)
-      activejob (= 6.0.3.2)
+    actionmailer (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      actionview (= 6.0.3.4)
+      activejob (= 6.0.3.4)
       mail (~> 2.5, >= 2.5.4)
       rails-dom-testing (~> 2.0)
-    actionpack (6.0.3.2)
-      actionview (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
+    actionpack (6.0.3.4)
+      actionview (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       rack (~> 2.0, >= 2.0.8)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      activerecord (= 6.0.3.2)
-      activestorage (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
+    actiontext (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activerecord (= 6.0.3.4)
+      activestorage (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       nokogiri (>= 1.8.5)
-    actionview (6.0.3.2)
-      activesupport (= 6.0.3.2)
+    actionview (6.0.3.4)
+      activesupport (= 6.0.3.4)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (6.0.3.2)
-      activesupport (= 6.0.3.2)
+    activejob (6.0.3.4)
+      activesupport (= 6.0.3.4)
       globalid (>= 0.3.6)
-    activemodel (6.0.3.2)
-      activesupport (= 6.0.3.2)
-    activerecord (6.0.3.2)
-      activemodel (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
-    activestorage (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      activejob (= 6.0.3.2)
-      activerecord (= 6.0.3.2)
+    activemodel (6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activerecord (6.0.3.4)
+      activemodel (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activestorage (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activejob (= 6.0.3.4)
+      activerecord (= 6.0.3.4)
       marcel (~> 0.3.1)
-    activesupport (6.0.3.2)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
@@ -78,7 +78,7 @@ GEM
     ast (2.4.1)
     banzai (0.1.3)
     builder (3.2.4)
-    concurrent-ruby (1.1.6)
+    concurrent-ruby (1.1.7)
     crass (1.0.6)
     deep_merge (1.2.1)
     diff-lcs (1.4.2)
@@ -89,9 +89,9 @@ GEM
       activesupport (>= 4.2.0)
     hansi (0.2.0)
     hash-deep-merge (0.1.1)
-    i18n (1.8.3)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    loofah (2.6.0)
+    loofah (2.7.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     mail (2.7.1)
@@ -102,14 +102,14 @@ GEM
     mimemagic (0.3.5)
     mini_mime (1.0.2)
     mini_portile2 (2.4.0)
-    minitest (5.14.1)
+    minitest (5.14.2)
     mustermann (1.1.1)
       ruby2_keywords (~> 0.0.1)
     mustermann-contrib (1.1.1)
       hansi (~> 0.2.0)
       mustermann (= 1.1.1)
     neatjson (0.9)
-    nexmo_markdown_renderer (0.4.1)
+    nexmo_markdown_renderer (0.4.2)
       activemodel (~> 6.0)
       banzai (~> 0.1.2)
       i18n (~> 1.7)
@@ -117,8 +117,8 @@ GEM
       octicons_helper (~> 8.2)
       redcarpet (~> 3.4)
       rouge (~> 2.0.7)
-    nio4r (2.5.2)
-    nokogiri (1.10.9)
+    nio4r (2.5.4)
+    nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
     oas_parser (0.25.1)
       activesupport (>= 4.0.0)
@@ -136,35 +136,35 @@ GEM
     parallel (1.19.2)
     parser (2.7.1.4)
       ast (~> 2.4.1)
-    public_suffix (4.0.5)
+    public_suffix (4.0.6)
     rack (2.2.3)
-    rack-protection (2.0.8.1)
+    rack-protection (2.1.0)
       rack
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
-    rails (6.0.3.2)
-      actioncable (= 6.0.3.2)
-      actionmailbox (= 6.0.3.2)
-      actionmailer (= 6.0.3.2)
-      actionpack (= 6.0.3.2)
-      actiontext (= 6.0.3.2)
-      actionview (= 6.0.3.2)
-      activejob (= 6.0.3.2)
-      activemodel (= 6.0.3.2)
-      activerecord (= 6.0.3.2)
-      activestorage (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
+    rails (6.0.3.4)
+      actioncable (= 6.0.3.4)
+      actionmailbox (= 6.0.3.4)
+      actionmailer (= 6.0.3.4)
+      actionpack (= 6.0.3.4)
+      actiontext (= 6.0.3.4)
+      actionview (= 6.0.3.4)
+      activejob (= 6.0.3.4)
+      activemodel (= 6.0.3.4)
+      activerecord (= 6.0.3.4)
+      activestorage (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       bundler (>= 1.3.0)
-      railties (= 6.0.3.2)
+      railties (= 6.0.3.4)
       sprockets-rails (>= 2.0.0)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
     rails-html-sanitizer (1.3.0)
       loofah (~> 2.3)
-    railties (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
+    railties (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       method_source
       rake (>= 0.8.7)
       thor (>= 0.20.3, < 2.0)
@@ -210,15 +210,15 @@ GEM
       rb-inotify (~> 0.9, >= 0.9.7)
     shotgun (0.9.2)
       rack (>= 1.0)
-    sinatra (2.0.8.1)
+    sinatra (2.1.0)
       mustermann (~> 1.0)
-      rack (~> 2.0)
-      rack-protection (= 2.0.8.1)
+      rack (~> 2.2)
+      rack-protection (= 2.1.0)
       tilt (~> 2.0)
     sprockets (4.0.2)
       concurrent-ruby (~> 1.0)
       rack (> 1, < 3)
-    sprockets-rails (3.2.1)
+    sprockets-rails (3.2.2)
       actionpack (>= 4.0)
       activesupport (>= 4.0)
       sprockets (>= 3.0.0)
@@ -228,10 +228,10 @@ GEM
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
-    websocket-driver (0.7.2)
+    websocket-driver (0.7.3)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    zeitwerk (2.3.1)
+    zeitwerk (2.4.1)
 
 PLATFORMS
   ruby

data/Procfile

@@ -0,0 +1 @@
+web: bundle exec ./exe/nexmo-oas-renderer

data/app.json

@@ -0,0 +1,15 @@
+{
+  "buildpacks": [{ "url": "heroku/ruby" }],
+  "env": {
+    "RACK_ENV": "production",
+    "RAILS_ENV": "production",
+    "OAS_PATH": "samples"
+  },
+  "stack": "heroku-18",
+  "formation": {
+    "web": {
+      "quantity": 1,
+      "size": "free"
+    }
+  }
+}

data/lib/nexmo/oas/renderer/app.rb

@@ -13,6 +13,7 @@ require_relative './presenters/open_api_specification'
 require_relative './presenters/navigation'
 require_relative './presenters/request_body_raw'
 require_relative './presenters/response_tabs'
+require_relative './presenters/content_switcher'
 require_relative './helpers/render'
 require_relative './helpers/navigation'
 require_relative './helpers/summary'

data/lib/nexmo/oas/renderer/presenters/content_switcher.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Nexmo
+  module OAS
+    module Renderer
+      module Presenters
+        class ContentSwitcher
+          def initialize(format:, label:, theme_light:, force_type: nil)
+            @format = format
+            @panels = []
+            @label = label
+            @force_type = force_type
+            @theme_light = theme_light
+          end
+
+          def add_content(title:, content:, tab_id:, active:)
+            @panels.push({
+                             'title' => title,
+                             'content' => content,
+                             'x-tab-id' => tab_id,
+                             'active' => active,
+                         })
+          end
+
+          def render
+            type = 'tabs'
+            type = 'dropdown' if @panels.length >= 8
+
+            type = @force_type if @force_type
+
+            [:"open_api/content_switcher/_#{type}", locals: {
+                panels: @panels,
+                format: @format,
+                label: @label,
+                switcher: self,
+                theme_light: @theme_light,
+            }]
+          end
+
+          def id
+            @id ||= "s-#{SecureRandom.hex}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nexmo/oas/renderer/presenters/response_tabs.rb

@@ -8,7 +8,7 @@ module Nexmo
     module Renderer
       module Presenters
         class ResponseTabs
-          attr_reader :format
+          attr_reader :format, :switcher
 
           def initialize(format, response, content, endpoint, theme_light: nil)
             @format   = format
@@ -16,6 +16,7 @@ module Nexmo
             @content  = content
             @endpoint = endpoint
             @theme_light = theme_light
+            @switcher ||= @response.schema(@format)['x-switcher']
           end
 
           def tab_links

data/lib/nexmo/oas/renderer/public/assets/javascripts/nexmo-oas-renderer.js

@@ -1,4 +1,9 @@
-if(document.querySelector(".oas-wrapper")){
+document.addEventListener("DOMContentLoaded", function() {
+  // Only run this JS on OAS pages
+  if(!document.querySelector(".oas-wrapper")){
+    return;
+  }
+
   if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
     var queryString = new URLSearchParams(window.location.search);
     if (!queryString.get('theme')) {
@@ -7,59 +12,64 @@ if(document.querySelector(".oas-wrapper")){
     }
   }
 
-  document.addEventListener("DOMContentLoaded", function() {
-    // Handle people clicking on oneOf tabs by changing every one on the page
-    var oneOfTabs = document.querySelectorAll('[data-tab-link]');
-    Array.from(oneOfTabs).forEach(function (element) {
-      element.addEventListener('click', function (event) {
-        var link = event.target.getAttribute('data-tab-link');
-        var matchingTabs = document.querySelectorAll('[data-tab-link="' + link + '"]');
-        Array.from(matchingTabs).forEach(function (element) {
-          element.dispatchEvent(new Event('toggle'));
-        });
+  // Handle people clicking on oneOf tabs by changing every one on the page
+  var oneOfTabs = document.querySelectorAll('[data-tab-link]');
+  Array.from(oneOfTabs).forEach(function (element) {
+    element.addEventListener('click', function (event) {
+      var link = event.target.getAttribute('data-tab-link');
+      var matchingTabs = document.querySelectorAll('[data-tab-link="' + link + '"]');
+      Array.from(matchingTabs).forEach(function (element) {
+        element.dispatchEvent(new Event('toggle'));
+
+        // Switch anything that's in a dropdown
+        if (element.parentNode.className.indexOf("Vlt-dropdown__panel__content") !== -1) {
+          // This is *very* structure dependent, but also the most compatible way to handle it
+          var panel = element.parentNode.parentNode;
+          var titleNodes = Array.from(panel.previousSibling.previousSibling.firstChild.childNodes);
+          titleNodes[1].textContent = element.textContent;
+        }
       });
     });
+  });
 
-    var toggleTopNav = function(event, closeOnly) {
+  var toggleTopNav = function(event, closeOnly) {
 
-      if (event) {
-        if (!Array.from(event.target.classList).includes("oas-trigger")) {
-          return;
-        }
-      }
-
-      var c = document.querySelector('.oas-trigger-content');
-      if (closeOnly === true) {
-        c.style.display = "none";
+    if (event) {
+      if (!Array.from(event.target.classList).includes("oas-trigger")) {
         return;
       }
-      c.style.display = c.style.display == 'block' ? 'none' : "block";
-    };
+    }
 
-    if (document.querySelector('.oas-trigger')) {
-      document.querySelector('.oas-trigger').addEventListener("click", toggleTopNav);
+    var c = document.querySelector('.oas-trigger-content');
+    if (closeOnly === true) {
+      c.style.display = "none";
+      return;
     }
+    c.style.display = c.style.display == 'block' ? 'none' : "block";
+  };
+
+  if (document.querySelector('.oas-trigger')) {
+    document.querySelector('.oas-trigger').addEventListener("click", toggleTopNav);
+  }
 
-    document.querySelectorAll('a').forEach((element) => {
-      var href = element.getAttribute("href");
-      if (!href){ return; }
-      if (href.slice(0,1) !== "#"){ return; }
-      element.addEventListener('click', function (event) {
-        event.preventDefault();
+  document.querySelectorAll('a').forEach((element) => {
+    var href = element.getAttribute("href");
+    if (!href){ return; }
+    if (href.slice(0,1) !== "#"){ return; }
+    element.addEventListener('click', function (event) {
+      event.preventDefault();
 
-        toggleTopNav(null, true);
+      toggleTopNav(null, true);
 
-        var to = document.querySelector(event.target.hash)
-        history.pushState({}, '', event.target.href);
-        window.scrollTo({
-          top: (window.scrollY + to.getBoundingClientRect().y) - 70,
-          left: 0,
-        })
+      var to = document.querySelector(event.target.hash)
+      history.pushState({}, '', event.target.href);
+      window.scrollTo({
+        top: (window.scrollY + to.getBoundingClientRect().y) - 70,
+        left: 0,
+      })
 
 
-      });
     });
-
   });
-}
+});
 

data/lib/nexmo/oas/renderer/public/assets/javascripts/volta.dropdown.js

@@ -0,0 +1,145 @@
+/**
+ * Copyright (c) 2001-present, Vonage.
+ *
+ * Dropdowns (requires core)
+ */
+
+'use strict';
+
+Volta.dropdown = function () {
+	var _class = {
+		wrapper: 'Vlt-dropdown',
+		block: 'Vlt-dropdown__block',
+		btn: 'Vlt-dropdown__trigger',
+		btnLegacy: 'Vlt-dropdown__btn',
+		dismissed: 'Vlt-callout--dismissed',
+		expanded: 'Vlt-dropdown--expanded',
+		label: 'Vlt-dropdown__label',
+		link: 'Vlt-dropdown__link',
+		noCloseLink: 'Vlt-dropdown__link--noclose',
+		noCloseBlock: 'Vlt-dropdown__block--noclose',
+		panel: 'Vlt-dropdown__panel',
+		panelContent: 'Vlt-dropdown__panel__content',
+		selection: 'Vlt-dropdown__selection',
+		switch: 'Vlt-switch',
+		switchSlider: 'Vlt-switch__slider'
+	}
+
+	function Dropdown() {}
+
+	Dropdown.prototype = {
+		init: function(element, supressClickHandler) {
+			this.dropdown = element;
+			this.selection = this.dropdown.querySelector('.' + _class.selection);
+			this.isSelectionVisible = !!this.selection;
+			this.btn = this.dropdown.querySelector('.' + _class.btn) || this.dropdown.querySelector('.' + _class.btnLegacy);
+			this._suppress = supressClickHandler;
+
+			if(!this._suppress) {
+				this._addEventListener();
+			}
+		},
+		_addEventListener: function(){
+			var openHandler = this.open.bind(this);
+			this.dropdown.addEventListener('click', openHandler, { once: true })
+		},
+		close: function(text) {
+			if(text) {
+				this._setDropdownSelectionText(text);
+			}
+			this.dropdown.classList.remove(_class.expanded);
+
+			if(!this._suppress){
+				this._addEventListener();
+			}
+
+		},
+		_closeEventHandler: undefined,
+		_closeEvent: function(e) {
+			var targetIsPanel = Volta._hasClass(e.target, _class.panel);
+			var parentIsPanel = Volta._closest(e.target, '.' + _class.panelContent, _class.panel) !== null;
+			var parentLink = Volta._closest(e.target, '.' + _class.link, _class.wrapper);
+			var parentIsLink = parentLink && parentLink.length === 1;
+			var isSwitchSlider = Volta._hasClass(e.target, _class.switchSlider);
+			var isParentSwitch = Volta._closest(e.target,'.' + _class.switch, _class.link);
+			var isNoClose = Volta._hasClass(e.target, _class.noCloseLink) || Volta._hasClass(e.target, _class.noCloseBlock);
+			var isNoCloseParent = Volta._closest(e.target,'.' + _class.noCloseLink, _class.link) || Volta._closest(e.target,'.' + _class.noCloseBlock, _class.noCloseBlock);
+			var isInput = e.target instanceof HTMLInputElement;
+
+			if(!targetIsPanel && !parentIsPanel && !parentIsLink && !isNoClose && !isInput && !isNoCloseParent) {
+				e.preventDefault();
+				e.stopPropagation();
+			}
+
+			if(isSwitchSlider || isParentSwitch || isNoClose || isInput || isNoCloseParent) {
+				return null;
+			}
+
+			var text;
+			if(parentIsPanel && Volta._hasClass(e.target, _class.label)) {
+				text = e.target.innerHTML;
+			} else if (parentIsPanel) {
+				var label = e.target.querySelector('.' + _class.label);
+				if(label) {
+					text = label.innerHTML;
+				}
+			}
+
+			this.close(text);
+
+			document.querySelector('body').removeEventListener('click', this._closeEventHandler );
+		},
+		open: function(event) {
+			if(event) {
+				event.preventDefault();
+				event.stopPropagation();
+			}
+
+			this.dropdown.classList.add(_class.expanded);
+
+			if(!this._suppress){
+				this._closeEventHandler = this._closeEvent.bind(this);
+				document.querySelector('body').addEventListener('click', this._closeEventHandler );
+			}
+		},
+		_setDropdownSelectionText: function(text) {
+			if(this.isSelectionVisible) {
+				this.selection.innerText = text;
+			} else {
+				this.btn.innerText = text;
+				this.btn.value = text;
+			}
+		},
+		_suppress: false
+	}
+
+	return {
+		create: create,
+		init: attachDropdownHandlers
+	}
+
+	/**
+	 *	@public
+	 *
+	 *	@description Attach a listeners to dropdowns
+	 */
+	function attachDropdownHandlers() {
+		document.querySelectorAll('.' + _class.wrapper).forEach(attachHandler);
+
+		function attachHandler(dropdown) {
+			create(dropdown);
+		}
+	}
+
+	/**
+	 *	@private
+	 *
+	 *	@description Create a dropdown element
+	 *  @param {HTMLElement} element
+ 	 */
+	function create(element){
+		var dropdown = Object.create(Dropdown.prototype, {})
+		dropdown.init(element);
+		return dropdown;
+	}
+}();

data/lib/nexmo/oas/renderer/public/assets/stylesheets/nexmo-oas-renderer.css

@@ -53,6 +53,7 @@
   .oas-wrapper .oas-parameter-description {
     margin-left: 16px; }
   .oas-wrapper .oas-parameter-meta {
+    padding-bottom: 2px;
     border-bottom: 1px solid #ccc;
     margin-bottom: 4px; }
   .oas-wrapper .oas-parameter-nested {

data/lib/nexmo/oas/renderer/version.rb

@@ -3,7 +3,7 @@
 module Nexmo
   module OAS
     module Renderer
-      VERSION = '2.1.1'
+      VERSION = '2.4.0'
     end
   end
 end

data/lib/nexmo/oas/renderer/views/layouts/_javascripts.erb

@@ -5,10 +5,11 @@
 <script src="/assets/javascripts/volta.accordion.js"></script>
 <script src="/assets/javascripts/volta.tabs.js"></script>
 <script src="/assets/javascripts/volta.modal.js"></script>
+<script src="/assets/javascripts/volta.dropdown.js"></script>
 <script src="/assets/javascripts/volta.tooltip.js"></script>
 <script src="/assets/javascripts/nexmo-oas-renderer.js?a=1"></script>
 <script src="/assets/javascripts/components/format.js"></script>
 <script type="text/javascript">
-  Volta.init(["accordion", "tab", "modal", "tooltip"]);
+  Volta.init(["accordion", "tab", "modal", "tooltip", "dropdown"]);
   new Format
 </script>

data/lib/nexmo/oas/renderer/views/open_api/_errors.erb

@@ -0,0 +1,34 @@
+<% if definition.raw['x-errors'] %>
+    <div>
+        <div class="Vlt-grid">
+            <div class="Vlt-col oas-left-panel" style="padding-bottom: 36px;">
+                <h2 id="errors">Errors</h2>
+                <p>
+                  The following is a non-exhaustive list of error codes that may occur while using this API. These codes are in addition to any of our <a href="/api-errors">generic error codes</a>.
+                </p>
+            </div>
+            <div class="Vlt-col oas-right-panel"></div>
+        </div>
+        <div class="Vlt-grid">
+            <div class="Vlt-col Vlt-table oas-left-panel">
+                <table>
+                    <thead>
+                        <tr>
+                            <th>Code</th>
+                            <th>Details</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                    <% definition.raw['x-errors'].each do |name, body| %>
+                        <tr>
+                          <td><a href="/api-errors/<%= @specification.definition_name %>#<%= name %>"><b><%= name %></b></a></td>
+                            <td><%= body['description'].render_markdown %> </td>
+                        </tr>
+                    <% end %>
+                    </tbody>
+                </table>
+            </div>
+            <div class="Vlt-col oas-right-panel"></div>
+        </div>
+    </div>
+<% end %>

data/lib/nexmo/oas/renderer/views/open_api/_header.erb

@@ -39,6 +39,20 @@
       </div>
     </div>
 
+
+    <% if @specification.groups.size > 1 %>
+      <h4>Jump to:</h4>
+      <div style="margin-bottom: 30px; padding: 8px;">
+      <% @specification.groups.each do |name, endpoints| %>
+        <% if name %>
+          <% group = definition.raw['tags'].detect { |tag| tag['name'].capitalize == name.capitalize } %>
+          <p><a href="#<%= group['name'].parameterize %>"><%= group['name'] %> &raquo;</a></p>
+          <p class="Vlt-grey-darker"><%= group['description']&.render_markdown %></p>
+        <% end %>
+      <% end %>
+      </div>
+    <% end %>
+
     <%
       # If there's only one group, everything is untagged
       if @specification.groups.size === 1

data/lib/nexmo/oas/renderer/views/open_api/_navigation.erb

@@ -13,6 +13,9 @@
     <a href="#webhooks" class="Vlt-btn Vlt-btn--tertiary group-link">Webhooks</a>
   <% end %>
 
+  <% if definition.raw['x-errors'] %>
+    <a href="#errors" class="Vlt-btn Vlt-btn--tertiary group-link">Errors</a>
+  <% end %>
 
   <% if @specification.formats.size > 1 %>
     <div class="Vlt-native-dropdown">
@@ -44,6 +47,10 @@
       <a href="#top" class="Vlt-btn Vlt-btn--tertiary group-link">Available Operations</a>
       <% end %>
 
+      <% if definition.raw['x-errors'] %>
+        <a href="#errors" class="Vlt-btn Vlt-btn--tertiary group-link">Errors</a>
+      <% end %>
+
       <br />
       <br />
 

data/lib/nexmo/oas/renderer/views/open_api/_parameter_groups.erb

@@ -29,14 +29,7 @@
   <% unless endpoint.request_body.exhibits_one_of_multiple_schemas?(format) %>
 
     <%
-      # @mheap: This is hacky handling for allOf, but it works for now
-      # We probably want real allOf support in OasParser, but that's more time than I have right now
-      allOf = endpoint.request_body.content[format]['schema']['allOf']
-      if allOf
-        params = endpoint.request_body.handle_all_of(allOf)
-      else
-        params = endpoint.request_body.properties_for_format(format)
-      end
+      params = endpoint.request_body.properties_for_format(format)
       if params
     %>
 
@@ -46,9 +39,10 @@
 
     <%
       # This can likely be better done as a presenter, but it works for now
-      schema = endpoint.request_body.content[format]['schema']['oneOf']
+      request = endpoint.request_body.content[format]['schema']
+      schema = request['oneOf']
       %>
-      <%= erb :'open_api/_tabbed_parameters', locals: { body: endpoint.request_body, schema: schema, format: format, callback: callback } %>
+      <%= erb :'open_api/_tabbed_parameters', locals: { body: endpoint.request_body, request: request, schema: schema, format: format, callback: callback } %>
     <%
     end
   end

data/lib/nexmo/oas/renderer/views/open_api/_parameters.erb

@@ -65,6 +65,12 @@
         <% if parameter.maximum || parameter.raw['maxLength'] %>
           | <span class="constraint">Max:</span> <%= parameter.maximum || parameter.raw['maxLength'] %>
         <% end %>
+        <% if parameter.raw['deprecated'] %>             
+          | <span class="constraint">DEPRECATED</span> <span>: This field has been deprecated. </span>          
+        <% end %>
+        <% if parameter.raw['x-replace-with']%>            
+            <span> <%= 'Please use ' + '<code>'+ parameter.raw['x-replace-with'] + '</code>' + ' instead.' %> </span>
+        <% end %>
       </div>
 
       <%= (parameter.description || parameter.schema['description'] || '').render_markdown %>

data/lib/nexmo/oas/renderer/views/open_api/_response_tabs.erb

@@ -1,18 +1,16 @@
-<% tabs = Nexmo::OAS::Renderer::Presenters::ResponseTabs.new(format, response, content, endpoint, theme_light: @theme_light) %>
+<%
+  tabs = Nexmo::OAS::Renderer::Presenters::ResponseTabs.new(format, response, content, endpoint, theme_light: @theme_light)
 
-<div class='Vlt-tabs js-format' data-format='<%= tabs.format %>'>
-  <div class='Vlt-tabs__header' role='tablist' aria-label='Responses'>
-    <% tabs.tab_links.each do |link| %>
-      <div role='tab' class='<%= link.css_classes %>' <% if link.data_tab_link %>data-tab-link="<%= link.data_tab_link %>"<% end %>>
-        <%= link.content %>
-      </div>
-    <% end %>
-  </div>
-  <div class='Vlt-tabs__content'>
-    <% tabs.tab_panels.each do |panel| %>
-      <div class='<%= panel.css_classes %>'>
-        <%= erb *panel.content %>
-      </div>
-    <% end %>
-  </div>
-</div>
+  switcher = Nexmo::OAS::Renderer::Presenters::ContentSwitcher.new(label: "Response Example", format: format, force_type: tabs.switcher, theme_light: @theme_light)
+
+  tabs.tab_links.each_with_index do |v,k|
+     switcher.add_content(
+       title: v.content,
+       content: (erb *tabs.tab_panels[k].content),
+       tab_id: v.data_tab_link,
+       active: k == 0
+     )
+  end
+%>
+
+<%= erb *switcher.render %>

data/lib/nexmo/oas/renderer/views/open_api/_tabbed_parameters.erb

@@ -12,8 +12,7 @@
     s
   end
 
-
-  panels = []
+  switcher = Nexmo::OAS::Renderer::Presenters::ContentSwitcher.new(label: "Request Details", format: format, force_type: request['x-switcher'], theme_light: @theme_light)
 
   schemas.each_with_index do |schema, index|
     if schema['properties']
@@ -25,40 +24,21 @@
       end
     end
 
-    panels.push({
-      'description' => schema['title'] || schema['description'],
-      'parameters' => schema['properties'],
-      'oneOf' => schema['oneOf'],
-      'x-tab-id' => schema['x-tab-id'] || schema['title'].parameterize,
-      'active' => index == 0
-    })
+
+    if schema['oneOf']
+      content = (erb :'open_api/_tabbed_parameters', locals: { body: body, request: schema, schema: schema['oneOf'], format: format, callback: callback })
+    else
+      content = (erb :'open_api/_parameters', locals: { parameters: schema['properties'], callback: callback })
+    end
+
+    switcher.add_content(
+      title: schema['title'] || schema['description'],
+      content: content,
+      tab_id: schema['x-tab-id'],
+      active: index == 0
+    )
   end
 %>
 
-<div class="Vlt-tabs js-format" data-format="<%= format %>">
-  <div class="Vlt-tabs__header" role="tablist" aria-label="Responses">
-    <% panels.each do |panel| %>
-      <div role="tab" data-tab-link="<%= panel['x-tab-id'] %>" class="Vlt-tabs__link <%= panel['active'] ? 'Vlt-tabs__link_active' : '' %>">
-        <%= panel['description'] %>
-      </div>
-    <% end %>
-  </div>
-  <div class="Vlt-tabs__content">
-    <% panels.each do |panel| %>
-      <div class="Vlt-tabs__panel <%= panel['active'] ? 'Vlt-tabs__panel_active' : '' %>">
-      <%
-        # Nested oneOf?
-        if panel['oneOf']
-          %>
-          <%= erb :'open_api/_tabbed_parameters', locals: { body: body, schema: panel['oneOf'], format: format, callback: callback } %>
-        <%
-        else
-        %>
-
-        <%= erb :'open_api/_parameters', locals: { parameters: panel['parameters'], callback: callback } %>
-      <% end %>
-      </div>
-    <% end %>
-  </div>
-</div>
+<%= erb *switcher.render %>
 

data/lib/nexmo/oas/renderer/views/open_api/content_switcher/_dropdown.erb

@@ -0,0 +1,22 @@
+<div class="Vlt-dropdown Vlt-dropdown--full-width">
+  <div class="Vlt-dropdown__trigger Vlt-dropdown__trigger--btn"><button class="Vlt-btn Vlt-btn--<%= (theme_light ? "secondary" : "tertiary") %>"><%= label %>: <span class="Vlt-dropdown__selection"><%= panels[0]['title'] %></span></button></div>
+  <div class="Vlt-dropdown__panel">
+    <div data-tab-content="<%= switcher.id %>" class="Vlt-dropdown__panel__content">
+      <% panels.each do |panel| %>
+        <div role="tab" data-tab-link="<%= panel['x-tab-id'] || panel['title'].parameterize %>" class="Vlt-dropdown__link Vlt-dropdown__label Vlt-js-tabs__link"><%= panel['title'] %></div>
+      <% end %>
+    </div>
+  </div>
+</div>
+
+
+<div class="js-format" data-format="<%= format %>">
+  <div id="<%= switcher.id %>" class="Vlt-js-tabs__content">
+    <% panels.each do |panel| %>
+      <div class="Vlt-js-tabs__panel <%= panel['active'] ? 'Vlt-js-tabs__panel_active' : '' %>">
+        <%= panel['content'] %>
+      </div>
+    <% end %>
+  </div>
+</div>
+

data/lib/nexmo/oas/renderer/views/open_api/content_switcher/_tabs.erb

@@ -0,0 +1,18 @@
+<div class="Vlt-tabs js-format" data-format="<%= format %>">
+  <div class="Vlt-tabs__header" role="tablist" aria-label="<%= label %>">
+    <% panels.each do |panel| %>
+      <div role="tab" data-tab-link="<%= panel['x-tab-id'] || panel['title'].parameterize %>" class="Vlt-tabs__link <%= panel['active'] ? 'Vlt-tabs__link_active' : '' %>">
+        <%= panel['title'] %>
+      </div>
+    <% end %>
+  </div>
+  <div class="Vlt-tabs__content">
+    <% panels.each do |panel| %>
+      <div class="Vlt-tabs__panel <%= panel['active'] ? 'Vlt-tabs__panel_active' : '' %>">
+        <%= panel['content'] %>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+

data/lib/nexmo/oas/renderer/views/open_api/show.erb

@@ -21,6 +21,6 @@
     <% end %>
 
     <%= erb :'open_api/_webhooks', locals: { definition: definition } %>
-
+    <%= erb :'open_api/_errors', locals: {definition: definition } %>
   </div>
 </div>

data/nexmo-oas-renderer.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|samples)/}) }
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nexmo-oas-renderer
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.4.0
 platform: ruby
 authors:
 - Fabian Rodriguez
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-21 00:00:00.000000000 Z
+date: 2020-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -243,6 +243,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".env.example"
+- ".github/workflows/pull_request-review.yml"
 - ".github/workflows/push-docker-publish.yml"
 - ".gitignore"
 - ".rspec"
@@ -254,8 +255,10 @@ files:
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- Procfile
 - README.md
 - Rakefile
+- app.json
 - bin/console
 - bin/setup
 - exe/nexmo-oas-renderer
@@ -271,6 +274,7 @@ files:
 - lib/nexmo/oas/renderer/helpers/summary.rb
 - lib/nexmo/oas/renderer/helpers/url.rb
 - lib/nexmo/oas/renderer/presenters/api_specification.rb
+- lib/nexmo/oas/renderer/presenters/content_switcher.rb
 - lib/nexmo/oas/renderer/presenters/endpoint.rb
 - lib/nexmo/oas/renderer/presenters/groups.rb
 - lib/nexmo/oas/renderer/presenters/navigation.rb
@@ -300,6 +304,7 @@ files:
 - lib/nexmo/oas/renderer/public/assets/javascripts/tooltip.min.js
 - lib/nexmo/oas/renderer/public/assets/javascripts/volta.accordion.js
 - lib/nexmo/oas/renderer/public/assets/javascripts/volta.core.js
+- lib/nexmo/oas/renderer/public/assets/javascripts/volta.dropdown.js
 - lib/nexmo/oas/renderer/public/assets/javascripts/volta.modal.js
 - lib/nexmo/oas/renderer/public/assets/javascripts/volta.tabs.js
 - lib/nexmo/oas/renderer/public/assets/javascripts/volta.tooltip.js
@@ -348,6 +353,7 @@ files:
 - lib/nexmo/oas/renderer/views/open_api/_callbacks.erb
 - lib/nexmo/oas/renderer/views/open_api/_code_examples.erb
 - lib/nexmo/oas/renderer/views/open_api/_endpoint.erb
+- lib/nexmo/oas/renderer/views/open_api/_errors.erb
 - lib/nexmo/oas/renderer/views/open_api/_header.erb
 - lib/nexmo/oas/renderer/views/open_api/_model.erb
 - lib/nexmo/oas/renderer/views/open_api/_navigation.erb
@@ -365,6 +371,8 @@ files:
 - lib/nexmo/oas/renderer/views/open_api/_tabbed_parameters.erb
 - lib/nexmo/oas/renderer/views/open_api/_tabbed_single_parameter.erb
 - lib/nexmo/oas/renderer/views/open_api/_webhooks.erb
+- lib/nexmo/oas/renderer/views/open_api/content_switcher/_dropdown.erb
+- lib/nexmo/oas/renderer/views/open_api/content_switcher/_tabs.erb
 - lib/nexmo/oas/renderer/views/open_api/show.erb
 - lib/nexmo/oas/renderer/views/static/404.erb
 - nexmo-oas-renderer.gemspec