serverest 3.1.0 → 3.1.1

package/docs/flags/flag_peru.svg

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg
+	width="900"
+	height="600"
+	xmlns="http://www.w3.org/2000/svg"
+	id="Flag_of_Peru">
+	<rect height="600" width="900" fill="#D91023" x="0" y="0" />
+	<rect height="600" width="300" fill="white" x="300" y="0" />
+</svg>

package/docs/images/serverest_logo.svg

@@ -0,0 +1,116 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="3864.000000pt" height="1530.000000pt" viewBox="0 0 3864.000000 1530.000000"
+ preserveAspectRatio="xMidYMid meet">
+<metadata>
+Created by potrace 1.16, written by Peter Selinger 2001-2019
+</metadata>
+<g transform="translate(0.000000,1530.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M0 7650 l0 -7650 19320 0 19320 0 0 6865 0 6865 -695 0 -695 0 0
+-4342 c0 -2772 -4 -4365 -10 -4403 -12 -76 -53 -142 -114 -182 -96 -65 -105
+-66 -591 -71 -470 -4 -591 3 -673 38 -58 25 -114 79 -139 135 -17 38 -18 228
+-21 4432 l-2 4392 -923 4 -922 3 -106 26 c-364 90 -565 264 -646 558 -15 54
+-18 105 -18 295 0 228 0 231 26 286 47 101 130 164 265 205 56 18 183 19 2662
+21 l2602 3 0 85 0 85 -19320 0 -19320 0 0 -7650z m4275 7489 c189 -22 368 -75
+540 -161 380 -191 611 -483 702 -888 15 -67 17 -202 20 -1319 3 -885 1 -1259
+-7 -1297 -16 -76 -63 -141 -130 -178 l-55 -31 -305 -3 c-343 -4 -373 0 -495
+58 -124 59 -188 133 -219 255 -14 52 -16 198 -16 1167 0 1223 4 1140 -65 1217
+-51 56 -116 75 -239 69 -110 -5 -161 -28 -204 -90 -51 -76 -56 -103 -48 -313
+31 -894 221 -1667 748 -3055 66 -173 167 -439 225 -590 120 -318 317 -900 397
+-1175 279 -962 405 -1776 409 -2648 2 -237 -1 -296 -16 -371 -111 -547 -492
+-916 -1069 -1036 -313 -65 -715 -48 -994 41 -492 157 -807 504 -901 991 -17
+86 -18 184 -18 1318 l0 1225 24 53 c29 64 86 115 155 139 45 16 88 18 346 18
+253 0 304 -3 359 -18 125 -35 220 -101 279 -194 64 -100 62 -58 62 -1240 0
+-1173 -3 -1104 59 -1176 46 -52 107 -72 216 -72 104 1 153 15 202 58 63 55 73
+91 73 265 0 432 -57 921 -165 1405 -137 612 -330 1212 -697 2157 -368 947
+-574 1594 -723 2272 -130 591 -182 1038 -192 1633 -5 289 -3 354 11 435 130
+743 832 1181 1731 1079z m26885 -19 c317 -28 589 -109 841 -251 419 -236 721
+-635 844 -1117 75 -293 76 -339 73 -2062 -3 -1403 -4 -1488 -21 -1531 -26 -67
+-79 -123 -145 -156 l-57 -28 -368 -3 c-343 -3 -374 -2 -449 17 -230 58 -388
+202 -427 389 -8 37 -11 464 -11 1420 0 869 -4 1391 -10 1432 -13 84 -77 215
+-133 272 -75 77 -164 107 -317 108 -212 0 -327 -68 -409 -245 -52 -109 -55
+-139 -48 -495 15 -834 112 -1443 351 -2216 159 -516 353 -971 791 -1864 264
+-537 362 -755 520 -1155 353 -890 579 -1838 670 -2800 44 -474 74 -1320 56
+-1583 -16 -228 -56 -425 -122 -604 -240 -653 -758 -1066 -1474 -1174 -163 -25
+-511 -25 -679 0 -405 59 -753 222 -1021 478 -280 267 -452 602 -537 1048 -22
+115 -22 117 -25 1684 -3 1384 -2 1575 12 1621 20 69 87 144 157 176 53 24 54
+24 438 24 424 0 445 -2 576 -66 119 -59 225 -179 268 -303 21 -60 21 -74 26
+-1441 l5 -1380 22 -52 c87 -214 218 -294 461 -280 53 2 120 12 147 22 114 38
+204 140 248 280 21 66 22 86 20 345 -5 747 -77 1330 -248 1995 -187 732 -408
+1299 -905 2315 -494 1011 -733 1641 -935 2465 -206 839 -287 1507 -302 2495
+-6 437 -1 532 42 745 34 171 85 318 171 490 95 194 179 311 334 465 388 389
+948 574 1570 520z m-22122 -29 c65 -29 124 -94 154 -170 21 -52 22 -71 23
+-281 0 -180 -4 -242 -18 -310 -48 -224 -166 -386 -341 -470 -131 -62 -138 -63
+-740 -67 l-549 -5 6 -1656 c4 -911 7 -1982 7 -2379 l0 -723 670 0 c434 0 686
+-4 718 -11 74 -15 152 -66 190 -123 60 -91 67 -132 66 -406 -1 -261 -14 -361
+-63 -491 -91 -240 -289 -397 -551 -439 -38 -6 -267 -10 -547 -10 l-483 0 0
+-647 c0 -357 3 -1428 7 -2380 l6 -1733 511 0 c281 0 542 -5 579 -10 292 -42
+482 -237 538 -550 21 -117 19 -480 -3 -551 -26 -84 -76 -142 -155 -181 l-68
+-33 -1320 0 c-1234 0 -1323 1 -1370 18 -67 23 -118 66 -146 124 -21 45 -23 64
+-30 338 -4 160 -10 3134 -14 6611 -7 5758 -6 6325 8 6375 30 101 103 162 215
+178 31 5 640 8 1352 7 l1295 -1 53 -24z m2831 6 c264 -43 474 -113 679 -226
+396 -218 667 -562 781 -989 59 -220 54 -18 58 -2652 3 -1710 1 -2447 -7 -2525
+-39 -394 -178 -712 -415 -951 l-90 -91 50 -34 c117 -80 250 -228 324 -360 39
+-70 86 -197 114 -309 l21 -85 3 -2593 c2 -1777 0 -2606 -7 -2632 -15 -57 -67
+-119 -130 -154 l-55 -31 -545 0 -545 0 -53 29 c-59 33 -108 88 -128 144 -11
+30 -13 497 -14 2523 0 1622 -3 2505 -10 2540 -25 136 -122 256 -242 300 -59
+21 -81 23 -365 27 l-303 4 0 -2679 0 -2678 -24 -50 c-13 -29 -44 -69 -70 -92
+-84 -74 -76 -73 -647 -73 -489 0 -510 1 -564 21 -66 25 -137 91 -159 151 -15
+39 -16 605 -14 6668 l3 6625 28 56 c31 64 82 105 155 125 37 10 257 13 1057
+10 890 -2 1022 -4 1114 -19z m2923 -8 c244 -95 401 -286 437 -529 6 -41 133
+-2325 282 -5075 148 -2750 273 -5013 277 -5029 4 -15 132 2255 284 5045 214
+3914 281 5088 293 5134 54 202 207 371 410 452 l70 28 383 3 c446 4 468 1 538
+-73 50 -52 64 -101 64 -226 0 -124 -1076 -14279 -1091 -14349 -34 -162 -139
+-263 -300 -289 -85 -14 -1221 -14 -1309 -1 -164 26 -252 116 -294 300 -16 67
+-1088 14195 -1090 14360 -2 143 46 223 156 261 49 17 84 19 438 16 l385 -2 67
+-26z m6264 -1 c88 -46 136 -114 160 -226 17 -82 19 -387 3 -517 -40 -322 -186
+-529 -439 -619 l-85 -31 -557 -3 -558 -3 0 -2158 c0 -1187 3 -2401 7 -2699 l6
+-541 621 -3 621 -3 53 -30 c64 -35 96 -71 131 -145 l26 -55 0 -290 c0 -266 -2
+-297 -22 -377 -66 -258 -206 -421 -427 -495 l-81 -27 -462 -4 -463 -3 0 -2377
+c0 -1307 3 -2488 7 -2624 l6 -247 546 -4 c609 -4 610 -4 745 -74 94 -49 200
+-154 248 -248 79 -152 108 -317 108 -607 0 -258 -26 -351 -121 -432 -87 -74 7
+-69 -1449 -70 -1206 -1 -1309 0 -1360 16 -63 20 -123 65 -147 111 -45 87 -42
+-271 -54 7342 -11 6676 -10 7205 5 7264 30 118 85 174 195 197 43 10 367 12
+1371 11 l1315 -2 51 -27z m2688 7 c254 -30 439 -82 656 -186 553 -266 874
+-736 930 -1364 8 -83 10 -852 8 -2475 -4 -2159 -5 -2364 -21 -2459 -61 -375
+-183 -634 -409 -867 l-87 -90 57 -41 c240 -169 394 -427 444 -744 11 -68 13
+-566 13 -2649 l0 -2565 -23 -47 c-26 -53 -72 -97 -135 -130 l-42 -23 -540 0
+-540 0 -51 27 c-57 30 -108 83 -133 137 -15 33 -16 259 -21 2571 l-5 2535 -31
+65 c-40 83 -89 139 -151 172 -94 52 -142 58 -445 58 l-278 0 -2 -2678 -3
+-2677 -28 -58 c-19 -38 -44 -69 -75 -92 -85 -65 -91 -66 -658 -63 l-509 3 -57
+28 c-70 34 -124 94 -143 161 -13 44 -15 853 -15 6616 0 4700 3 6583 11 6625
+20 111 70 175 161 206 50 17 109 18 1023 19 804 0 992 -3 1099 -15z m4760 1
+c92 -28 156 -91 193 -189 22 -57 30 -373 13 -505 -38 -301 -178 -491 -427
+-579 l-78 -28 -569 -3 -569 -3 6 -562 c4 -309 7 -1382 7 -2384 l0 -1823 683 0
+c750 0 742 1 825 -60 55 -40 99 -101 120 -169 14 -47 17 -97 17 -301 0 -255
+-8 -329 -47 -450 -80 -248 -241 -404 -486 -472 -73 -21 -103 -22 -596 -26
+l-519 -3 6 -727 c4 -400 7 -1471 7 -2379 l0 -1653 530 0 c600 0 625 -2 769
+-72 114 -55 203 -143 260 -259 73 -151 96 -292 89 -567 -4 -150 -8 -185 -26
+-232 -29 -73 -68 -119 -133 -155 l-54 -30 -400 -8 c-220 -4 -821 -6 -1335 -5
+-868 3 -938 5 -980 21 -80 32 -116 62 -147 124 l-28 58 -6 1245 c-4 685 -8
+3666 -10 6625 l-4 5380 23 50 c38 83 94 127 185 145 23 4 625 8 1338 9 1098 1
+1303 -1 1343 -13z m-26059 -10689 c53 -30 100 -94 127 -175 21 -64 23 -84 26
+-444 l3 -378 1097 -2 1097 -3 57 -28 c77 -38 134 -96 171 -175 l32 -67 3 -347
+c2 -223 0 -374 -8 -420 -24 -157 -131 -269 -285 -297 -40 -8 -394 -11 -1112
+-11 l-1053 0 0 -347 c0 -376 -7 -437 -53 -530 -31 -60 -91 -116 -142 -133 -54
+-18 -141 -7 -205 25 -29 15 -220 149 -424 298 -204 149 -609 444 -901 655
+-291 211 -552 405 -578 430 -28 28 -63 77 -85 121 -33 68 -36 80 -36 161 0 81
+3 93 36 161 23 47 56 93 90 125 71 69 1816 1330 1897 1371 54 28 74 33 135 33
+55 0 80 -5 111 -23z m34026 -10 c35 -17 330 -226 654 -463 325 -236 738 -537
+918 -668 276 -200 335 -247 372 -297 59 -80 80 -145 80 -244 -1 -106 -38 -190
+-122 -273 -65 -64 -1831 -1344 -1904 -1380 -58 -29 -152 -39 -204 -22 -50 17
+-111 73 -140 130 -47 93 -55 171 -55 539 l0 340 -1087 3 -1088 3 -60 24 c-82
+33 -164 116 -194 195 -21 58 -22 67 -19 470 l3 411 27 50 c32 62 113 139 176
+168 l47 22 1098 3 1097 2 0 338 c0 360 7 436 46 522 54 119 112 160 225 160
+55 0 77 -5 130 -33z"/>
+<path d="M10990 11080 l0 -2721 308 3 307 3 54 28 c136 72 211 211 240 447 16
+123 15 4560 0 4632 -24 111 -96 217 -180 262 -96 53 -132 58 -441 63 l-288 5
+0 -2722z"/>
+<path d="M22940 11069 l0 -2720 298 3 297 3 67 33 c107 53 174 147 221 311
+l22 76 3 2334 c2 2117 1 2340 -14 2390 -29 101 -103 195 -188 238 -82 41 -175
+52 -453 53 l-253 0 0 -2721z"/>
+</g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "serverest",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Servidor REST local de forma rápida e simples para estudo de testes de API",
   "author": "Paulo Gonçalves <author@serverest.dev> (https://www.linkedin.com/in/paulo-goncalves/)",
   "license": "GPL-3.0",
@@ -111,6 +111,9 @@
     }
   },
   "standard": {
+    "ignore": [
+      "src/swagger/scripts/*.js"
+    ],
     "globals": [
       "after",
       "afterEach",

package/src/app.js

@@ -27,7 +27,7 @@ const { version } = require('../package.json')
 const swaggerDocument = require('../docs/swagger.json')
 const rateLimiter = require('./middlewares/rate-limiter')
 const { fetchLatestRelease } = require('./utils/github-release')
-const { buildCustomJsStr, customCss } = require('./swagger/customization')
+const { buildCustomJsStr, customCss } = require('./swagger')
 const { localizeSwaggerDocument } = require('./swagger/translations')
 
 const forceReleaseBanner = process.env.FORCE_RELEASE_BANNER === 'true'

package/src/controllers/produtos-controller.js

@@ -1,65 +1,65 @@
-'use strict'
-
-const carrinhosService = require('../services/carrinhos-service')
-const constant = require('../utils/constants')
-const service = require('../services/produtos-service')
-
-exports.get = async (req, res) => {
-  const produtos = await service.getAll(req.query)
-  res.status(200).send({ quantidade: produtos.length, produtos })
-}
-
-exports.getOne = async (req, res) => {
-  const { id } = req.params
-  const produto = await service.getOne(id)
-  if (!produto) {
-    return res.status(400).json({ message: constant.PRODUCT_NOT_FOUND })
-  }
-  return res.status(200).send(produto)
-}
-
-exports.post = async (req, res) => {
-  const { nome } = req.body
-  const trimmedName = nome.trim()
-
-  const productExists = await service.existeProduto({ nome: trimmedName })
-
-  if (productExists) {
-    return res.status(400).send({ message: constant.NAME_ALREADY_USED })
-  }
-
-  const { _id } = await service.criarProduto(req.body)
-
-  res.status(201).send({ message: constant.POST_SUCCESS, _id })
-}
-
-exports.delete = async (req, res) => {
-  const carrinhoDoUsuario = await carrinhosService.getAll({ produtos: { $elemMatch: { idProduto: req.params.id } } })
-  const usuarioTemCarrinho = carrinhoDoUsuario.length > 0
-  if (usuarioTemCarrinho) {
-    const idCarrinhos = carrinhoDoUsuario.map(carrinhos => carrinhos._id)
-    return res.status(400).send({ message: constant.DELETE_PRODUCT_WITH_CART, idCarrinhos })
-  }
-  const quantidadeRegistrosExcluidos = await service.deleteById(req.params.id)
-  const message = quantidadeRegistrosExcluidos === 0 ? constant.DELETE_NONE : constant.DELETE_SUCCESS
-  res.status(200).send({ message })
-}
-
-exports.put = async (req, res) => {
-  const { id } = req.params
-  const { nome } = req.body
-  const product = { nome: nome.trim(), $not: { _id: id } }
-
-  const productExists = await service.existeProduto(product)
-
-  if (productExists) {
-    return res.status(400).json({ message: constant.NAME_ALREADY_USED })
-  }
-
-  const updatedProduct = await service.createOrUpdateById(id, req.body)
-  if (updatedProduct._id !== id) {
-    return res.status(201).json({ message: constant.POST_SUCCESS, _id: updatedProduct._id })
-  }
-
-  return res.status(200).json({ message: constant.PUT_SUCCESS })
-}
+'use strict'
+
+const carrinhosService = require('../services/carrinhos-service')
+const constant = require('../utils/constants')
+const service = require('../services/produtos-service')
+
+exports.get = async (req, res) => {
+  const produtos = await service.getAll(req.query)
+  res.status(200).send({ quantidade: produtos.length, produtos })
+}
+
+exports.getOne = async (req, res) => {
+  const { id } = req.params
+  const produto = await service.getOne(id)
+  if (!produto) {
+    return res.status(400).json({ message: constant.PRODUCT_NOT_FOUND })
+  }
+  return res.status(200).send(produto)
+}
+
+exports.post = async (req, res) => {
+  const { nome } = req.body
+  const trimmedName = nome.trim()
+
+  const productExists = await service.existeProduto({ nome: trimmedName })
+
+  if (productExists) {
+    return res.status(400).send({ message: constant.NAME_ALREADY_USED })
+  }
+
+  const { _id } = await service.criarProduto(req.body)
+
+  res.status(201).send({ message: constant.POST_SUCCESS, _id })
+}
+
+exports.delete = async (req, res) => {
+  const carrinhoDoUsuario = await carrinhosService.getAll({ produtos: { $elemMatch: { idProduto: req.params.id } } })
+  const usuarioTemCarrinho = carrinhoDoUsuario.length > 0
+  if (usuarioTemCarrinho) {
+    const idCarrinhos = carrinhoDoUsuario.map(carrinhos => carrinhos._id)
+    return res.status(400).send({ message: constant.DELETE_PRODUCT_WITH_CART, idCarrinhos })
+  }
+  const quantidadeRegistrosExcluidos = await service.deleteById(req.params.id)
+  const message = quantidadeRegistrosExcluidos === 0 ? constant.DELETE_NONE : constant.DELETE_SUCCESS
+  res.status(200).send({ message })
+}
+
+exports.put = async (req, res) => {
+  const { id } = req.params
+  const { nome } = req.body
+  const product = { nome: nome.trim(), $not: { _id: id } }
+
+  const productExists = await service.existeProduto(product)
+
+  if (productExists) {
+    return res.status(400).json({ message: constant.NAME_ALREADY_USED })
+  }
+
+  const updatedProduct = await service.createOrUpdateById(id, req.body)
+  if (updatedProduct._id !== id) {
+    return res.status(201).json({ message: constant.POST_SUCCESS, _id: updatedProduct._id })
+  }
+
+  return res.status(200).json({ message: constant.PUT_SUCCESS })
+}

package/src/swagger/index.js

@@ -0,0 +1,62 @@
+'use strict'
+
+const { readFileSync, readdirSync } = require('fs')
+const { join } = require('path')
+
+const STYLES_DIR = join(__dirname, 'styles')
+const SCRIPTS_DIR = join(__dirname, 'scripts')
+const TRANSLATIONS_DIR = join(__dirname, 'translations')
+
+const STYLE_FILES = ['topbar.css', 'language-switcher.css', 'release-toast.css']
+
+function loadCustomCss () {
+  return STYLE_FILES
+    .map(file => readFileSync(join(STYLES_DIR, file), 'utf8'))
+    .join('\n')
+}
+
+function loadCustomJsTemplate () {
+  const files = readdirSync(SCRIPTS_DIR)
+    .filter(f => f.endsWith('.js'))
+    .sort()
+  return files
+    .map(file => readFileSync(join(SCRIPTS_DIR, file), 'utf8'))
+    .join('\n')
+}
+
+function buildUiLabelTranslations () {
+  const ptBr = require(join(TRANSLATIONS_DIR, 'pt-BR.js'))
+  const en = require(join(TRANSLATIONS_DIR, 'en.js'))
+  const es = require(join(TRANSLATIONS_DIR, 'es.js'))
+  const uiKeys = Object.keys(ptBr).filter(k => k.startsWith('ui.')).sort()
+  const summaryKeys = Object.keys(ptBr).filter(k => k.endsWith('.summary')).sort()
+  const keys = [...uiKeys, ...summaryKeys]
+  const entries = keys.map(key => {
+    const pt = JSON.stringify(ptBr[key] || '')
+    const enVal = JSON.stringify(en[key] || '')
+    const esVal = JSON.stringify(es[key] || '')
+    return `  { 'pt-BR': ${pt}, en: ${enVal}, es: ${esVal} }`
+  })
+  return entries.join(',\n')
+}
+
+const customCss = loadCustomCss()
+const customJsTemplate = loadCustomJsTemplate()
+
+function buildCustomJsStr (releaseInfo, currentVersion, forceBanner) {
+  const replacements = {
+    __RELEASE_INFO__: JSON.stringify(releaseInfo),
+    __CURRENT_VERSION__: JSON.stringify(currentVersion),
+    __FORCE_BANNER__: JSON.stringify(forceBanner),
+    __UI_LABEL_TRANSLATIONS__: buildUiLabelTranslations()
+  }
+  return Object.keys(replacements).reduce(
+    (output, key) => output.split(key).join(replacements[key]),
+    customJsTemplate
+  )
+}
+
+module.exports = {
+  buildCustomJsStr,
+  customCss
+}

package/src/swagger/scripts/01-config.js

@@ -0,0 +1,10 @@
+/* global __RELEASE_INFO__, __CURRENT_VERSION__, __FORCE_BANNER__, NodeFilter, MutationObserver, caches */
+(function () {
+  const releaseInfo = __RELEASE_INFO__
+  const currentVersion = __CURRENT_VERSION__
+  const forceBanner = __FORCE_BANNER__
+
+  function normalizeVersion (version) {
+    if (!version) return ''
+    return version.toString().trim().replace(/^v/i, '')
+  }

package/src/swagger/scripts/02-language-storage.js

@@ -0,0 +1,55 @@
+const flagUrls = {
+  'pt-BR': '/flags/flag_brazil.svg',
+  en: '/flags/flag_uk.svg',
+  es: '/flags/flag_peru.svg'
+}
+
+const supportedLanguages = [
+  { code: 'pt-BR', label: 'Português do Brasil' },
+  { code: 'es', label: 'Español' },
+  { code: 'en', label: 'English' }
+]
+
+function getPreferredLanguage () {
+  return window.localStorage.getItem('swaggerLanguage') || 'pt-BR'
+}
+
+function setPreferredLanguage (code) {
+  window.localStorage.setItem('swaggerLanguage', code)
+}
+
+function getLanguageFromQuery () {
+  const url = new URL(window.location.href)
+  return url.searchParams.get('lang') || ''
+}
+
+function getCurrentLanguageCode () {
+  const queryLang = getLanguageFromQuery()
+  const preferred = getPreferredLanguage()
+  return supportedLanguages.some(l => l.code === queryLang)
+    ? queryLang
+    : (supportedLanguages.some(l => l.code === preferred) ? preferred : 'pt-BR')
+}
+
+function preloadFlags () {
+  if (typeof document === 'undefined' || !document.head) return
+  Object.values(flagUrls).forEach(href => {
+    const link = document.createElement('link')
+    link.rel = 'preload'
+    link.as = 'image'
+    link.href = href
+    document.head.appendChild(link)
+  })
+}
+
+function preloadSwaggerJson () {
+  if (typeof document === 'undefined' || !document.head) return
+  const code = getCurrentLanguageCode()
+  const href = '/swagger.json?lang=' + encodeURIComponent(code)
+  const link = document.createElement('link')
+  link.rel = 'preload'
+  link.as = 'fetch'
+  link.href = href
+  link.crossOrigin = ''
+  document.head.appendChild(link)
+}

package/src/swagger/scripts/03-release-toast.js

@@ -0,0 +1,158 @@
+const releaseToastTranslations = {
+  'pt-BR': {
+    title: 'Nova release disponível',
+    link: 'Ver release',
+    closeLabel: 'Fechar aviso de release',
+    meta: (latest, current) => 'v' + latest + ' (v' + current + ' instalada)'
+  },
+  en: {
+    title: 'New release available',
+    link: 'View release',
+    closeLabel: 'Close release notice',
+    meta: (latest, current) => 'v' + latest + ' (v' + current + ' installed)'
+  },
+  es: {
+    title: 'Nueva versión disponible',
+    link: 'Ver versión',
+    closeLabel: 'Cerrar aviso de versión',
+    meta: (latest, current) => 'v' + latest + ' (v' + current + ' instalada)'
+  }
+}
+
+function getReleaseToastTranslation (language) {
+  return releaseToastTranslations[language] || releaseToastTranslations['pt-BR']
+}
+
+function renderReleaseToast (releaseDataOverride) {
+  const info = releaseDataOverride !== undefined ? releaseDataOverride : releaseInfo
+  const current = normalizeVersion(currentVersion)
+  let latestVersion = normalizeVersion(info && (info.version || info.tag))
+  if (forceBanner) {
+    latestVersion = normalizeVersion('999.999.999')
+  }
+  if (!latestVersion || (!current && !forceBanner)) return
+  if (latestVersion === current && !forceBanner) return
+  if (document.querySelector('.release-toast')) return
+  const root = document.querySelector('.swagger-ui') || document.body
+
+  const toast = document.createElement('div')
+  toast.className = 'release-toast'
+  toast.setAttribute('aria-live', 'polite')
+  toast.dataset.latestVersion = latestVersion
+  toast.dataset.currentVersion = current
+
+  const content = document.createElement('div')
+  content.className = 'release-toast__content'
+
+  const title = document.createElement('div')
+  title.className = 'release-toast__title'
+  const titleIcon = document.createElement('span')
+  titleIcon.className = 'release-toast__title-icon'
+  titleIcon.textContent = '⚡'
+  const translation = getReleaseToastTranslation(getPreferredLanguage())
+  const titleText = document.createElement('span')
+  titleText.textContent = translation.title
+  title.appendChild(titleIcon)
+  title.appendChild(titleText)
+
+  const meta = document.createElement('div')
+  meta.className = 'release-toast__meta'
+  meta.textContent = translation.meta(latestVersion, current)
+
+  const link = document.createElement('a')
+  link.className = 'release-toast__link'
+  link.href = (info && info.url) ? info.url : 'https://github.com/ServeRest/ServeRest/releases'
+  link.textContent = translation.link
+  link.target = '_blank'
+  link.rel = 'noopener noreferrer'
+
+  const close = document.createElement('button')
+  close.type = 'button'
+  close.className = 'release-toast__close'
+  close.setAttribute('aria-label', translation.closeLabel)
+  close.textContent = '×'
+  close.addEventListener('click', function () {
+    toast.remove()
+  })
+
+  content.appendChild(title)
+  content.appendChild(meta)
+  content.appendChild(link)
+  toast.appendChild(content)
+  toast.appendChild(close)
+  root.appendChild(toast)
+}
+
+function updateReleaseToastLanguage (language) {
+  const toast = document.querySelector('.release-toast')
+  if (!toast) return
+  const translation = getReleaseToastTranslation(language)
+  const latestVersion = toast.dataset.latestVersion || ''
+  const current = toast.dataset.currentVersion || ''
+  const title = toast.querySelector('.release-toast__title span:last-child')
+  const meta = toast.querySelector('.release-toast__meta')
+  const link = toast.querySelector('.release-toast__link')
+  const close = toast.querySelector('.release-toast__close')
+  if (title) title.textContent = translation.title
+  if (meta) meta.textContent = translation.meta(latestVersion, current)
+  if (link) link.textContent = translation.link
+  if (close) close.setAttribute('aria-label', translation.closeLabel)
+}
+
+const RELEASE_CACHE_KEY = 'serverest_github_release'
+const RELEASE_CACHE_TTL_MS = 10 * 60 * 1000
+
+function getCachedRelease (requireFresh) {
+  try {
+    const raw = window.localStorage.getItem(RELEASE_CACHE_KEY)
+    if (!raw) return null
+    const parsed = JSON.parse(raw)
+    if (!parsed || !parsed.data) return null
+    if (requireFresh && (!parsed.cachedAt || (Date.now() - parsed.cachedAt) > RELEASE_CACHE_TTL_MS)) return null
+    return parsed.data
+  } catch (_) {
+    return null
+  }
+}
+
+function runReleaseCheck () {
+  renderReleaseToast()
+  const cached = getCachedRelease(true)
+  if (cached && cached.tag_name && cached.html_url) {
+    renderReleaseToast({
+      tag: cached.tag_name,
+      version: normalizeVersion(cached.tag_name),
+      url: cached.html_url
+    })
+    return
+  }
+  fetch('https://api.github.com/repos/ServeRest/ServeRest/releases/latest', {
+    headers: { Accept: 'application/json' }
+  })
+    .then(r => r.json())
+    .then(data => {
+      if (data.tag_name && data.html_url) {
+        try {
+          window.localStorage.setItem(RELEASE_CACHE_KEY, JSON.stringify({
+            data: { tag_name: data.tag_name, html_url: data.html_url },
+            cachedAt: Date.now()
+          }))
+        } catch (_) {}
+        renderReleaseToast({
+          tag: data.tag_name,
+          version: normalizeVersion(data.tag_name),
+          url: data.html_url
+        })
+      }
+    })
+    .catch(() => {
+      const stale = getCachedRelease(false)
+      if (stale && stale.tag_name && stale.html_url) {
+        renderReleaseToast({
+          tag: stale.tag_name,
+          version: normalizeVersion(stale.tag_name),
+          url: stale.html_url
+        })
+      }
+    })
+}

package/src/swagger/scripts/04-ui-translations.js

@@ -0,0 +1,92 @@
+/* uiLabelTranslations injetado no build a partir de src/swagger/translations/*.js */
+const uiLabelTranslations = [
+  __UI_LABEL_TRANSLATIONS__
+]
+
+const buildExactMap = (targetLang) => {
+  const map = new Map()
+  uiLabelTranslations.forEach(labels => {
+    const target = labels[targetLang]
+    if (!target) return
+    Object.keys(labels).forEach(sourceLang => {
+      if (sourceLang === targetLang) return
+      const source = labels[sourceLang]
+      if (!source || source === target) return
+      map.set(source, target)
+    })
+  })
+  return map
+}
+
+const uiTranslations = {
+  'pt-BR': {
+    exact: buildExactMap('pt-BR'),
+    replace: [
+      { regex: /\binteger\b/g, value: 'inteiro' }
+    ]
+  },
+  en: {
+    exact: buildExactMap('en'),
+    replace: []
+  },
+  es: {
+    exact: buildExactMap('es'),
+    replace: [
+      { regex: /\binteger\b/g, value: 'entero' }
+    ]
+  }
+}
+
+let originalTextNodes = new WeakMap()
+
+function resetTranslationCache () {
+  originalTextNodes = new WeakMap()
+}
+
+function shouldTranslateNode (node) {
+  if (!node || !node.nodeValue || !node.nodeValue.trim()) return false
+  const parent = node.parentElement
+  if (!parent) return false
+  if (parent.closest('.lang-switcher')) return false
+  return !parent.closest('code, pre, textarea, input')
+}
+
+function translateNodeText (node, language) {
+  const config = uiTranslations[language] || uiTranslations['pt-BR']
+  if (!originalTextNodes.has(node)) {
+    originalTextNodes.set(node, node.nodeValue)
+  }
+  const original = originalTextNodes.get(node)
+  const trimmed = original.trim()
+  if (config.exact.has(trimmed)) {
+    const updated = original.replace(trimmed, config.exact.get(trimmed))
+    if (updated !== node.nodeValue) {
+      node.nodeValue = updated
+    }
+    return
+  }
+  let updated = original
+  config.replace.forEach(({ regex, value }) => {
+    updated = updated.replace(regex, value)
+  })
+  if (updated !== original) {
+    node.nodeValue = updated
+    return
+  }
+  if (node.nodeValue !== original) {
+    node.nodeValue = original
+  }
+}
+
+function applyTranslations (language) {
+  const root = document.querySelector('.swagger-ui')
+  if (!root || !window.NodeFilter || !document.createTreeWalker) return
+  const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+    acceptNode: node => (shouldTranslateNode(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_REJECT)
+  })
+  const nodes = []
+  while (walker.nextNode()) {
+    nodes.push(walker.currentNode)
+  }
+  nodes.forEach(node => translateNodeText(node, language))
+}