serverest 3.0.1 → 3.1.1

package/src/swagger/scripts/05-swagger-spec.js

@@ -0,0 +1,110 @@
+const swaggerSpecCache = {}
+
+function updateSpecUrlInDom (specUrlString) {
+  const root = document.querySelector('.swagger-ui')
+  if (!root) return
+  root.querySelectorAll('input').forEach(input => {
+    if (input.value && input.value.includes('swagger.json')) {
+      input.value = specUrlString
+    }
+  })
+  root.querySelectorAll('a[href*="swagger.json"]').forEach(a => {
+    if (a.getAttribute('href') && a.getAttribute('href').includes('swagger.json')) {
+      a.setAttribute('href', specUrlString)
+    }
+  })
+  if (root.querySelectorAll) {
+    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null, false)
+    const textNodes = []
+    while (walker.nextNode()) textNodes.push(walker.currentNode)
+    textNodes.forEach(node => {
+      if (node.nodeValue && node.nodeValue.includes('swagger.json?lang=')) {
+        node.nodeValue = node.nodeValue.replace(
+          /https?:\/\/[^"\s]+\/swagger\.json\?lang=[^"\s&]+/g,
+          specUrlString
+        )
+      }
+    })
+  }
+}
+
+function prefetchSwaggerSpecs () {
+  const code = getCurrentLanguageCode()
+  const url = '/swagger.json?lang=' + encodeURIComponent(code)
+  fetch(url)
+    .then(r => r.json())
+    .then(spec => { swaggerSpecCache[code] = spec })
+    .catch(() => {})
+}
+
+function updateSwaggerSpec (language, shouldRefreshOpenOps = false) {
+  const specUrl = new URL('/swagger.json', window.location.origin)
+  specUrl.searchParams.set('lang', language)
+  updateSpecUrlInDom(specUrl.toString())
+  const applySpec = (spec) => {
+    if (!window.ui || !window.ui.specActions) return
+    resetTranslationCache()
+    window.ui.specActions.updateSpec(JSON.stringify(spec))
+    if (window.ui.specActions.updateUrl) {
+      window.ui.specActions.updateUrl(specUrl.toString())
+    }
+    setTimeout(() => updateSpecUrlInDom(specUrl.toString()), 0)
+    if (window.ui.specActions.updateJsonSpec) {
+      window.ui.specActions.updateJsonSpec(spec)
+    }
+    let parsedSpec = null
+    if (window.ui.specActions.parseToJson) {
+      parsedSpec = window.ui.specActions.parseToJson(JSON.stringify(spec))
+    }
+    if (parsedSpec && window.ui.specActions.updateJsonSpec) {
+      window.ui.specActions.updateJsonSpec(parsedSpec)
+    }
+    if (window.ui.specActions.updateResolved) {
+      window.ui.specActions.updateResolved(parsedSpec || spec)
+    }
+    if (window.ui.specActions.invalidateResolvedSubtreeCache) {
+      window.ui.specActions.invalidateResolvedSubtreeCache()
+    }
+    if (window.ui.specActions.resolveSpec) {
+      const resolveResult = window.ui.specActions.resolveSpec(specUrl.toString())
+      if (resolveResult && typeof resolveResult.catch === 'function') {
+        resolveResult.catch(() => {})
+      }
+    }
+    if (shouldRefreshOpenOps) {
+      refreshOpenOperations()
+    }
+  }
+  const cached = swaggerSpecCache[language]
+  if (cached) {
+    applySpec(cached)
+    return
+  }
+  fetch(specUrl.toString())
+    .then(response => response.json())
+    .then(spec => {
+      swaggerSpecCache[language] = spec
+      applySpec(spec)
+    })
+    .catch(() => {})
+}
+
+function refreshOpenOperations () {
+  const openOperations = document.querySelectorAll('.opblock.is-open .opblock-summary')
+  if (!openOperations.length) return
+  const requestResolvedSubtree = window.ui?.specActions?.requestResolvedSubtree
+  if (requestResolvedSubtree) {
+    openOperations.forEach(summary => {
+      const opblock = summary.closest('.opblock')
+      if (!opblock) return
+      const methodText = opblock.querySelector('.opblock-summary-method')?.textContent?.trim() || ''
+      const pathText = opblock.querySelector('.opblock-summary-path')?.textContent?.trim() || ''
+      if (!methodText || !pathText) return
+      requestResolvedSubtree(['paths', pathText, methodText.toLowerCase()])
+    })
+  }
+  openOperations.forEach(summary => summary.click())
+  setTimeout(() => {
+    openOperations.forEach(summary => summary.click())
+  }, 0)
+}

package/src/swagger/scripts/06-language-switcher.js

@@ -0,0 +1,68 @@
+const lastLanguageKey = 'swaggerLastLanguage'
+
+function renderLanguageSwitcher (parent) {
+  if (document.querySelector('.lang-switcher')) return
+  const root = parent || document.querySelector('.swagger-ui')
+  if (!root) return
+  const currentLang = getPreferredLanguage()
+  root.setAttribute('data-docs-lang', currentLang)
+  const wrapper = document.createElement('div')
+  wrapper.className = 'lang-switcher'
+  wrapper.setAttribute('aria-label', 'Seleção de idioma')
+  let glowTimeoutId = null
+  supportedLanguages.forEach(language => {
+    const button = document.createElement('button')
+    button.type = 'button'
+    button.className = 'lang-switcher__button'
+    button.setAttribute('data-lang', language.code)
+    button.setAttribute('aria-label', language.label)
+    button.setAttribute('title', language.label)
+    const flagUrl = flagUrls[language.code]
+    if (flagUrl) {
+      const img = document.createElement('img')
+      img.className = 'lang-switcher__flag'
+      img.src = flagUrl
+      img.alt = ''
+      img.width = 20
+      img.height = 14
+      button.appendChild(img)
+    } else {
+      button.textContent = language.code
+    }
+    if (language.code === currentLang) {
+      button.classList.add('is-active')
+    }
+    button.addEventListener('click', () => {
+      if (language.code === getPreferredLanguage()) return
+      const previousLanguage = getPreferredLanguage()
+      window.sessionStorage.setItem(lastLanguageKey, previousLanguage)
+      setPreferredLanguage(language.code)
+      root.setAttribute('data-docs-lang', language.code)
+      if (glowTimeoutId) clearTimeout(glowTimeoutId)
+      wrapper.classList.remove('lang-switcher--glow')
+      wrapper.removeAttribute('data-glow-lang')
+      wrapper.offsetHeight
+      wrapper.classList.add('lang-switcher--glow')
+      wrapper.setAttribute('data-glow-lang', language.code)
+      glowTimeoutId = setTimeout(() => {
+        glowTimeoutId = null
+        wrapper.classList.remove('lang-switcher--glow')
+        wrapper.removeAttribute('data-glow-lang')
+      }, 1000)
+      const url = new URL(window.location.href)
+      url.searchParams.set('lang', language.code)
+      window.history.replaceState({}, '', url.toString())
+      wrapper.querySelectorAll('.lang-switcher__button').forEach(el => {
+        el.classList.toggle('is-active', el.getAttribute('data-lang') === language.code)
+      })
+      resetTranslationCache()
+      const shouldRefresh = setRefreshFlagFromState(language.code)
+      updateSwaggerSpec(language.code, shouldRefresh)
+      applyTranslations(language.code)
+      setTimeout(() => applyTranslations(language.code), 100)
+      updateReleaseToastLanguage(language.code)
+    })
+    wrapper.appendChild(button)
+  })
+  root.appendChild(wrapper)
+}

package/src/swagger/scripts/07-doc-lifecycle.js

@@ -0,0 +1,163 @@
+  let endpointBlockOpen = false
+
+  function hasOpenOperationHash () {
+    return typeof window.location.hash === 'string' && window.location.hash.includes('/')
+  }
+
+  function setEndpointBlockOpen (open) {
+    endpointBlockOpen = !!open
+  }
+
+  function shouldRefreshEndpointBlockNow (currentLanguage) {
+    if (!endpointBlockOpen) return false
+    const lastLang = window.sessionStorage.getItem(lastLanguageKey)
+    return !lastLang || lastLang !== currentLanguage
+  }
+
+  function setRefreshFlagFromState (currentLanguage) {
+    return shouldRefreshEndpointBlockNow(currentLanguage)
+  }
+
+  const docsVersionKey = 'serverest-docs-version'
+
+  function clearCachesAndReloadForNewVersion (newVersion) {
+    const unregister = typeof navigator !== 'undefined' && navigator.serviceWorker && navigator.serviceWorker.getRegistrations
+      ? navigator.serviceWorker.getRegistrations().then(regs => Promise.all(regs.map(r => r.unregister())))
+      : Promise.resolve()
+    const clearCaches = typeof caches !== 'undefined' && caches.keys
+      ? caches.keys().then(keys => Promise.all(keys.map(k => caches.delete(k))))
+      : Promise.resolve()
+    Promise.all([unregister, clearCaches]).then(() => {
+      window.sessionStorage.setItem(docsVersionKey, newVersion)
+      window.location.reload()
+    })
+  }
+
+  function checkVersionThenObserve () {
+    const root = document.querySelector('.swagger-ui')
+    if (root) {
+      runVersionCheckAndObserve()
+      return
+    }
+    const mo = new MutationObserver(function () {
+      if (document.querySelector('.swagger-ui')) {
+        mo.disconnect()
+        runVersionCheckAndObserve()
+      }
+    })
+    mo.observe(document.documentElement, { childList: true, subtree: true })
+  }
+
+  function runVersionCheckAndObserve () {
+    const normalizedCurrent = normalizeVersion(currentVersion)
+    const storedVersion = window.sessionStorage.getItem(docsVersionKey)
+    if (storedVersion && storedVersion !== normalizedCurrent) {
+      clearCachesAndReloadForNewVersion(normalizedCurrent)
+      return
+    }
+    if (!storedVersion) {
+      window.sessionStorage.setItem(docsVersionKey, normalizedCurrent)
+    }
+    observe()
+  }
+
+  function registerServiceWorker () {
+    if (typeof navigator !== 'undefined' && 'serviceWorker' in navigator) {
+      navigator.serviceWorker.register('/swagger-sw.js').catch(() => {})
+    }
+  }
+
+  function observe () {
+    const root = document.querySelector('.swagger-ui')
+    if (!root) {
+      setTimeout(observe, 500)
+      return
+    }
+    registerServiceWorker()
+    if (window.performance && window.performance.getEntriesByType) {
+      const navEntries = window.performance.getEntriesByType('navigation')
+      if (navEntries && navEntries[0] && navEntries[0].type === 'reload') {
+        window.sessionStorage.removeItem(lastLanguageKey)
+      }
+    }
+    const queryLanguage = getLanguageFromQuery()
+    const preferred = getPreferredLanguage()
+    const language = queryLanguage || preferred
+    if (language !== preferred) {
+      window.sessionStorage.setItem(lastLanguageKey, preferred)
+      setPreferredLanguage(language)
+    }
+    if (!queryLanguage) {
+      const url = new URL(window.location.href)
+      url.searchParams.set('lang', language)
+      window.history.replaceState({}, '', url.toString())
+    }
+    let translationScheduled = false
+    const scheduleTranslations = () => {
+      if (translationScheduled) return
+      translationScheduled = true
+      setTimeout(() => {
+        translationScheduled = false
+        applyTranslations(getPreferredLanguage())
+      }, 0)
+    }
+    const observer = new MutationObserver(scheduleTranslations)
+    observer.observe(root, { childList: true, subtree: true })
+    root.addEventListener('click', event => {
+      if (!event.isTrusted) return
+      const summary = event.target.closest ? event.target.closest('.opblock-summary') : null
+      if (!summary) return
+      const opblock = summary.closest('.opblock')
+      if (!opblock) return
+      setTimeout(() => {
+        if (opblock.classList.contains('is-open')) {
+          setEndpointBlockOpen(true)
+          window.sessionStorage.setItem(lastLanguageKey, getPreferredLanguage())
+        } else {
+          setEndpointBlockOpen(false)
+        }
+      }, 0)
+    })
+    renderLanguageSwitcher(root)
+    setupTopbarLogo(root)
+    scheduleTranslations()
+    if (hasOpenOperationHash()) {
+      setEndpointBlockOpen(true)
+    }
+    const shouldRefreshEndpointBlock = setRefreshFlagFromState(language)
+    updateSwaggerSpec(language, shouldRefreshEndpointBlock)
+    runReleaseCheck()
+  }
+
+  function setupTopbarLogo (root) {
+    function run () {
+      const wrapper = root.querySelector('.topbar-wrapper')
+      const link = wrapper && wrapper.querySelector('.link')
+      if (!wrapper || !link) return
+      if (document.getElementById('serverest-logo')) return
+      const logo = document.createElement('div')
+      logo.id = 'serverest-logo'
+      logo.className = 'topbar-logo'
+      wrapper.insertBefore(logo, link)
+      link.style.display = 'none'
+      link.removeAttribute('href')
+      link.setAttribute('aria-hidden', 'true')
+    }
+    run()
+    setTimeout(run, 300)
+  }
+
+  function init () {
+    preloadFlags()
+    preloadSwaggerJson()
+    prefetchSwaggerSpecs()
+    if (document.body) renderReleaseToast()
+    checkVersionThenObserve()
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', init)
+  } else {
+    init()
+  }
+})()

package/src/swagger/styles/language-switcher.css

@@ -0,0 +1,64 @@
+/* Seletor de idioma (bandeiras) */
+.swagger-ui .lang-switcher {
+  position: fixed;
+  left: 16px;
+  top: 24px;
+  display: flex;
+  gap: 6px;
+  background: rgba(255, 255, 255, 0.92);
+  border: 1px solid #e5e7eb;
+  border-radius: 999px;
+  padding: 4px 8px;
+  z-index: 9999;
+  box-shadow: 0px 2px 5px rgba(124, 58, 237, 0.5);
+  transition: box-shadow 1.5s ease-out;
+}
+
+.swagger-ui .lang-switcher.lang-switcher--glow {
+  transition: box-shadow 0.15s ease-out;
+}
+
+.swagger-ui .lang-switcher__button {
+  border: 0;
+  border-radius: 999px;
+  background: transparent;
+  cursor: pointer;
+  font-size: 16px;
+  line-height: 1;
+  padding: 4px;
+  opacity: 0.6;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.swagger-ui .lang-switcher__flag {
+  display: block;
+  width: 20px;
+  height: 14px;
+  border-radius: 2px;
+  object-fit: cover;
+}
+
+.swagger-ui .lang-switcher__button:hover {
+  opacity: 1;
+  transform: translateY(-2px);
+}
+
+.swagger-ui .lang-switcher__button.is-active {
+  opacity: 1;
+  transform: scale(1.3);
+}
+
+/* Brilho (shadow) em volta do lang-switcher na cor do país */
+.swagger-ui .lang-switcher[data-glow-lang='pt-BR'].lang-switcher--glow {
+  box-shadow: 0 0 6px #009739, 0 0 15px #009739;
+}
+
+.swagger-ui .lang-switcher[data-glow-lang='en'].lang-switcher--glow {
+  box-shadow: 0 0 6px #2c6bff, 0 0 15px #2c6bff;
+}
+
+.swagger-ui .lang-switcher[data-glow-lang='es'].lang-switcher--glow {
+  box-shadow: 0 0 6px #ff2b2b, 0 0 15px #ff2b2b;
+}

package/src/swagger/{custom-css.css → styles/release-toast.css}

@@ -1,63 +1,4 @@
-.swagger-ui .topbar-wrapper .link {
-  display: block;
-  height: 60px;
-  background: url(/images/serverest_logo.png) no-repeat center / contain;
-}
-
-.swagger-ui .topbar-wrapper .link svg { display: none; }
-
-.swagger-ui .topbar { background-color: #000000; border-bottom: 20px solid #7900e2; }
-
-.swagger-ui .markdown code,
-.swagger-ui .renderedMarkdown code {
-  font-size: 12px;
-}
-
-.swagger-ui .lang-switcher {
-  position: fixed;
-  left: 16px;
-  top: 16px;
-  display: flex;
-  gap: 6px;
-  background: rgba(255, 255, 255, 0.92);
-  border: 1px solid #e5e7eb;
-  border-radius: 999px;
-  padding: 4px 8px;
-  z-index: 9999;
-  box-shadow: 0px 2px 5px rgba(124, 58, 237, 0.5);
-}
-
-.swagger-ui .lang-switcher__button {
-  border: 0;
-  background: transparent;
-  cursor: pointer;
-  font-size: 16px;
-  line-height: 1;
-  padding: 4px;
-  opacity: 0.6;
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.swagger-ui .lang-switcher__flag {
-  display: block;
-  width: 20px;
-  height: 14px;
-  border-radius: 2px;
-  object-fit: cover;
-}
-
-.swagger-ui .lang-switcher__button:hover {
-  opacity: 1;
-  transform: translateY(-2px);
-}
-
-.swagger-ui .lang-switcher__button.is-active {
-  opacity: 1;
-  transform: scale(1.3);
-}
-
+/* Toast de nova release disponível */
 .swagger-ui .release-toast,
 .release-toast {
   position: fixed;

package/src/swagger/styles/topbar.css

@@ -0,0 +1,56 @@
+/* Topbar: link nativo desabilitado; logo exibida em #serverest-logo.topbar-logo (criado via JS) */
+.swagger-ui .topbar-wrapper {
+  display: flex;
+  align-items: center;
+}
+
+.swagger-ui .topbar-wrapper .link {
+  display: none;
+}
+
+/* Logo = só o SVG (id + classe), proporção exata, letras brancas, fundo transparente */
+#serverest-logo.topbar-logo {
+  position: relative;
+  display: block;
+  width: calc(60px * 3864 / 1530);
+  height: 60px;
+  padding: 0;
+  flex-shrink: 0;
+  overflow: hidden;
+  background: transparent;
+  box-sizing: border-box;
+}
+
+#serverest-logo.topbar-logo::before {
+  content: '';
+  position: absolute;
+  left: -2px;
+  top: 0;
+  right: -2px;
+  bottom: 0;
+  width: calc(100% + 4px);
+  height: 100%;
+  background-color: #ffffff;
+  -webkit-mask-image: linear-gradient(white, white), url(/images/serverest_logo.svg);
+  -webkit-mask-size: 100% 100%, 100% 100%;
+  -webkit-mask-position: center, center;
+  -webkit-mask-repeat: no-repeat, no-repeat;
+  -webkit-mask-composite: destination-out;
+  mask-image: linear-gradient(white, white), url(/images/serverest_logo.svg);
+  mask-size: 100% 100%, 100% 100%;
+  mask-position: center, center;
+  mask-repeat: no-repeat, no-repeat;
+  mask-composite: exclude;
+  pointer-events: none;
+}
+
+.swagger-ui .topbar {
+  position: relative;
+  background-color: #000000;
+  border-bottom: 20px solid #7900e2;
+}
+
+.swagger-ui .markdown code,
+.swagger-ui .renderedMarkdown code {
+  font-size: 12px;
+}

package/src/swagger/swagger-sw.js

@@ -30,9 +30,9 @@ const PREFETCH_PATHS = [
   '/swagger.json?lang=es',
   '/favicon.ico',
   '/flags/flag_brazil.svg',
-  '/flags/flag_spain.svg',
+  '/flags/flag_peru.svg',
   '/flags/flag_uk.svg',
-  '/images/serverest_logo.png',
+  '/images/serverest_logo.svg',
   '/swagger-ui.css',
   '/swagger-ui-init.js',
   '/swagger-ui-bundle.js',

package/src/swagger/translations/en.js

@@ -2,6 +2,29 @@
 'use strict'
 
 module.exports = {
+  'ui.parameters': 'Parameters',
+  'ui.parameter': 'Parameter',
+  'ui.responses': 'Responses',
+  'ui.response': 'Response',
+  'ui.request_body': 'Request body',
+  'ui.response_body': 'Response body',
+  'ui.example_value': 'Example Value',
+  'ui.model': 'Model',
+  'ui.value': 'Value',
+  'ui.description': 'Description',
+  'ui.required': 'Required',
+  'ui.try_it_out': 'Try it out',
+  'ui.execute': 'Execute',
+  'ui.cancel': 'Cancel',
+  'ui.clear': 'Clear',
+  'ui.authorize': 'Authorize',
+  'ui.servers': 'Servers',
+  'ui.no_parameters': 'No parameters',
+  'ui.no_responses': 'No responses',
+  'ui.loading': 'LOADING',
+  'ui.download': 'Download',
+  'ui.available_authorizations': 'Available authorizations',
+  'ui.example_lower': 'example',
   'info.description': '**ServeRest is a free REST API that simulates a virtual store to serve as study material for API testing.**\n\n**Don\'t forget to follow the [project author](https://github.com/PauloGoncalvesBH) and star the repository: [github.com/ServeRest/ServeRest](https://github.com/ServeRest/ServeRest)**\n\nThis page documents all routes and how to access them. For more details about ServeRest (how to run locally using Docker or NPM, change authentication timeout, etc), see [the ServeRest repository](https://github.com/serverest/serverest).\n\nUsing Postman? Import the [Swagger JSON](https://raw.githubusercontent.com/ServeRest/ServeRest/trunk/docs/swagger.json) to access the collections.\n\nDoing load testing? Read the \'[Load Testing](https://github.com/ServeRest/ServeRest#teste-de-carga)\' section.\n\n\nThank you ♥ to everyone who supports the project [financially](https://opencollective.com/serverest#section-contributors) or [with code, ideas, and promotion](https://github.com/ServeRest/ServeRest#contribuidores-); thanks to you **more than R$ 2000,00 were donated to the NGO [Todas as letras](https://todasasletras.org/)** so far.\n\nServeRest has a front-end in beta; check it out: [front.serverest.dev](https://front.serverest.dev).\n\nNeed help? [Open an issue](https://github.com/ServeRest/ServeRest/issues) or contact the project maintainer:\n',
   'tags.login.description': 'Authenticate your user to create a cart and, if you are an admin, manage products',
   'tags.usuarios.description': 'Manage users, check login data, and create admin users',

package/src/swagger/translations/es.js

@@ -2,6 +2,29 @@
 'use strict'
 
 module.exports = {
+  'ui.parameters': 'Parámetros',
+  'ui.parameter': 'Parámetro',
+  'ui.responses': 'Respuestas',
+  'ui.response': 'Respuesta',
+  'ui.request_body': 'Cuerpo de la solicitud',
+  'ui.response_body': 'Cuerpo de la respuesta',
+  'ui.example_value': 'Ejemplo',
+  'ui.model': 'Modelo',
+  'ui.value': 'Valor',
+  'ui.description': 'Descripción',
+  'ui.required': 'Obligatorio',
+  'ui.try_it_out': 'Probar',
+  'ui.execute': 'Ejecutar',
+  'ui.cancel': 'Cancelar',
+  'ui.clear': 'Limpiar',
+  'ui.authorize': 'Autorizar',
+  'ui.servers': 'Servidores',
+  'ui.no_parameters': 'Sin parámetros',
+  'ui.no_responses': 'Sin respuestas',
+  'ui.loading': 'Cargando',
+  'ui.download': 'Descargar',
+  'ui.available_authorizations': 'Autenticaciones disponibles',
+  'ui.example_lower': 'ejemplo',
   'info.description': '**ServeRest es una API REST gratuita que simula una tienda virtual para servir como material de estudio para pruebas de API.**\n\n**No olvides seguir al [autor del proyecto](https://github.com/PauloGoncalvesBH) y dar una estrella al repositorio: [github.com/ServeRest/ServeRest](https://github.com/ServeRest/ServeRest)**\n\nEsta página documenta todas las rutas y cómo acceder a ellas. Para más detalles sobre ServeRest (cómo ejecutar localmente usando Docker o NPM, cambiar el tiempo de expiración de autenticación, etc.) visita [el repositorio de ServeRest](https://github.com/serverest/serverest).\n\n¿Usas Postman? Importa el [JSON de Swagger](https://raw.githubusercontent.com/ServeRest/ServeRest/trunk/docs/swagger.json) para acceder a las colecciones.\n\n¿Vas a hacer pruebas de carga? Lee la sección \'[Pruebas de carga](https://github.com/ServeRest/ServeRest#teste-de-carga)\'.\n\n\nMuchas gracias ♥ a todos los que apoyan el proyecto [financieramente](https://opencollective.com/serverest#section-contributors) o [con código, ideas y difusión](https://github.com/ServeRest/ServeRest#contribuidores-), gracias a ustedes **más de R$ 2000,00 fueron donados a la ONG [Todas as letras](https://todasasletras.org/)** hasta el momento.\n\nServeRest tiene un front-end en beta, no dejes de conocerlo: [front.serverest.dev](https://front.serverest.dev).\n\n¿Necesitas ayuda? [Abre un issue](https://github.com/ServeRest/ServeRest/issues) o contacta al mantenedor del proyecto:\n',
   'tags.login.description': 'Autentica a tu usuario para crear un carrito y, si eres administrador, gestionar los productos',
   'tags.usuarios.description': 'Gestiona usuarios, consulta datos para inicio de sesión y crea administradores',

package/src/swagger/translations/pt-BR.js

@@ -2,6 +2,29 @@
 'use strict'
 
 module.exports = {
+  'ui.parameters': 'Parâmetros',
+  'ui.parameter': 'Parâmetro',
+  'ui.responses': 'Respostas',
+  'ui.response': 'Resposta',
+  'ui.request_body': 'Corpo da requisição',
+  'ui.response_body': 'Corpo da resposta',
+  'ui.example_value': 'Exemplo',
+  'ui.model': 'Modelo',
+  'ui.value': 'Valor',
+  'ui.description': 'Descrição',
+  'ui.required': 'Obrigatório',
+  'ui.try_it_out': 'Testar',
+  'ui.execute': 'Executar',
+  'ui.cancel': 'Cancelar',
+  'ui.clear': 'Limpar',
+  'ui.authorize': 'Autorizar',
+  'ui.servers': 'Servidores',
+  'ui.no_parameters': 'Sem parâmetros',
+  'ui.no_responses': 'Sem respostas',
+  'ui.loading': 'Carregando',
+  'ui.download': 'Baixar',
+  'ui.available_authorizations': 'Autenticações disponíveis',
+  'ui.example_lower': 'exemplo',
   'info.description': '**O ServeRest é uma API REST gratuita que simula uma loja virtual com intuito de servir de material de estudos de testes de API.**\n\n**Não deixe de seguir o [autor do projeto](https://github.com/PauloGoncalvesBH) e deixar um star no repositório: [github.com/ServeRest/ServeRest](https://github.com/ServeRest/ServeRest)**\n\nEssa página documenta todas as rotas e como acessá-las. Para mais detalhes do ServeRest (como executar localmente utilizando Docker ou NPM, alterar timeout de autenticação, etc) acesse [o repositório do ServeRest](https://github.com/serverest/serverest).\n\nEstá utilizando Postman? Importe o [JSON do Swagger](https://raw.githubusercontent.com/ServeRest/ServeRest/trunk/docs/swagger.json) para ter acesso às collections.\n\nVai fazer teste de carga? Leia a seção \'[Teste de Carga](https://github.com/ServeRest/ServeRest#teste-de-carga)\'.\n\n\nMuito obrigado ♥ a todos que apoiam o projeto [financeiramente](https://opencollective.com/serverest#section-contributors) ou [com código, ideias e divulgação](https://github.com/ServeRest/ServeRest#contribuidores-), graças a vocês **mais de R$ 2000,00 foram doados para a ONG [Todas as letras](https://todasasletras.org/)** até o momento.\n\nO ServeRest possui um front, com status em beta, não deixe de conhecer: [front.serverest.dev](https://front.serverest.dev).\n\nPrecisa de apoio? [Abra uma issue](https://github.com/ServeRest/ServeRest/issues) ou contate o mantenedor do projeto:\n',
   'tags.login.description': 'Autentique o seu usuário para montar um carrinho e, se for administrador, gerenciar os produtos',
   'tags.usuarios.description': 'Gerencie os usuários, consulte dados para login e cadastre administrador',