mastra 0.1.57-alpha.9 → 0.1.57-unstable.34

package/node_modules/swagger-ui-express/README.md

@@ -0,0 +1,360 @@
+# Swagger UI Express
+
+| Statements                  | Branches                | Functions                 | Lines                |
+| --------------------------- | ----------------------- | ------------------------- | -------------------- |
+| ![Statements](https://img.shields.io/badge/Coverage-89.87%25-yellow.svg) | ![Branches](https://img.shields.io/badge/Coverage-78.57%25-red.svg) | ![Functions](https://img.shields.io/badge/Coverage-91.67%25-brightgreen.svg) | ![Lines](https://img.shields.io/badge/Coverage-89.74%25-yellow.svg)    |
+
+This module allows you to serve auto-generated [swagger-ui](https://swagger.io/tools/swagger-ui/) generated API docs from express, based on a `swagger.json` file. The result is living documentation for your API hosted from your API server via a route.
+
+Swagger version is pulled from npm module swagger-ui-dist. Please use a lock file or specify the version of swagger-ui-dist you want to ensure it is consistent across environments.
+
+You may be also interested in:
+
+* [swagger-jsdoc](https://github.com/Surnet/swagger-jsdoc): Allows you to markup routes
+with jsdoc comments. It then produces a full swagger yml config dynamically, which you can pass to this module to produce documentation. See below under the usage section for more info.
+* [swagger tools](https://github.com/swagger-api): Various tools, including swagger editor, swagger code gen etc.
+
+## Usage
+
+Install using npm:
+
+```bash
+$ npm install swagger-ui-express
+```
+
+Express setup `app.js`
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
+```
+
+or if you are using Express router
+
+```javascript
+const router = require('express').Router();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+router.use('/api-docs', swaggerUi.serve);
+router.get('/api-docs', swaggerUi.setup(swaggerDocument));
+```
+
+Open http://`<app_host>`:`<app_port>`/api-docs in your browser to view the documentation.
+
+If you want to set up routing based on the swagger document checkout [swagger-express-router](https://www.npmjs.com/package/swagger-express-router)
+
+### [swagger-jsdoc](https://www.npmjs.com/package/swagger-jsdoc)
+
+If you are using swagger-jsdoc simply pass the swaggerSpec into the setup function:
+
+```javascript
+// Initialize swagger-jsdoc -> returns validated swagger spec in json format
+const swaggerSpec = swaggerJSDoc(options);
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));
+```
+
+### Swagger Explorer
+
+By default the Swagger Explorer bar is hidden, to display it pass true as the 'explorer' property of the options to the setup function:
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  explorer: true
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+### Custom swagger options
+
+To pass custom options e.g. validatorUrl, to the SwaggerUi client pass an object as the 'swaggerOptions' property of the options to the setup function:
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  swaggerOptions: {
+    validatorUrl: null
+  }
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+For all the available options, refer to [Swagger UI Configuration](https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md)
+
+### Custom CSS styles
+
+To customize the style of the swagger page, you can pass custom CSS as the 'customCss' property of the options to the setup function.
+
+E.g. to hide the swagger header:
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customCss: '.swagger-ui .topbar { display: none }'
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+### Custom CSS styles from Url
+
+You can also pass the url to a custom css file, the value must be the public url of the file and can be relative or absolute to the swagger path.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customCssUrl: '/custom.css'
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+You can also pass an array of css urls to load multiple css files.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customCssUrl: [
+    '/custom.css',
+    'https://example.com/other-custom.css'
+  ]
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+### Custom JS
+
+If you would like to have full control over your HTML you can provide your own javascript file, value accepts absolute or relative path. Value must be the public url of the js file.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customJs: '/custom.js'
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+You can also pass an array of js urls to load multiple js files.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customJs: [
+    '/custom.js',
+    'https://example.com/other-custom.js'
+  ]
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+It is also possible to add inline javascript, either as string or array of string.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customJsStr: 'console.log("Hello World")'
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+  customJsStr: [
+    'console.log("Hello World")',
+    `
+    var x = 1
+    console.log(x)
+    `
+  ]
+};
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+```
+
+### Load swagger from url
+
+To load your swagger from a url instead of injecting the document, pass `null` as the first parameter, and pass the relative or absolute URL as the 'url' property to 'swaggerOptions' in the setup function.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+
+var options = {
+  swaggerOptions: {
+    url: 'http://petstore.swagger.io/v2/swagger.json'
+  }
+}
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(null, options));
+```
+
+To load multiple swagger documents from urls as a dropdown in the explorer bar, pass an array of object with `name` and `url` to 'urls' property to 'swaggerOptions' in the setup function.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+
+var options = {
+  explorer: true,
+  swaggerOptions: {
+    urls: [
+      {
+        url: 'http://petstore.swagger.io/v2/swagger.json',
+        name: 'Spec1'
+      },
+      {
+        url: 'http://petstore.swagger.io/v2/swagger.json',
+        name: 'Spec2'
+      }
+    ]
+  }
+}
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(null, options));
+```
+
+Make sure 'explorer' option is set to 'true' in your setup options for the dropdown to be visible.
+
+
+### Load swagger from yaml file
+
+To load your swagger specification yaml file you need to use a module able to convert yaml to json; for instance `yaml`.
+
+    npm install yaml
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const fs = require("fs")
+const YAML = require('yaml')
+
+const file  = fs.readFileSync('./swagger.yaml', 'utf8')
+const swaggerDocument = YAML.parse(file)
+
+app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
+```
+
+
+### Modify swagger file on the fly before load
+
+To dynamically set the host, or any other content, in the swagger file based on the incoming request object you may pass the json via the req object; to achieve this just do not pass the the swagger json to the setup function and it will look for `swaggerDoc` in the `req` object.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {}
+
+app.use('/api-docs', function(req, res, next){
+    swaggerDocument.host = req.get('host');
+    req.swaggerDoc = swaggerDocument;
+    next();
+}, swaggerUi.serveFiles(swaggerDocument, options), swaggerUi.setup());
+```
+
+### Two swagger documents
+
+To run 2 swagger ui instances with different swagger documents, use the serveFiles function instead of the serve function. The serveFiles function has the same signature as the setup function.
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocumentOne = require('./swagger-one.json');
+const swaggerDocumentTwo = require('./swagger-two.json');
+
+var options = {}
+
+app.use('/api-docs-one', swaggerUi.serveFiles(swaggerDocumentOne, options), swaggerUi.setup(swaggerDocumentOne));
+
+app.use('/api-docs-two', swaggerUi.serveFiles(swaggerDocumentTwo, options), swaggerUi.setup(swaggerDocumentTwo));
+
+app.use('/api-docs-dynamic', function(req, res, next){
+  req.swaggerDoc = swaggerDocument;
+  next();
+}, swaggerUi.serveFiles(), swaggerUi.setup());
+```
+
+### Link to Swagger document
+
+To render a link to the swagger document for downloading within the swagger ui - then serve the swagger doc as an endpoint and use the url option to point to it:
+
+```javascript
+const express = require('express');
+const app = express();
+const swaggerUi = require('swagger-ui-express');
+const swaggerDocument = require('./swagger.json');
+
+var options = {
+    swaggerOptions: {
+        url: "/api-docs/swagger.json",
+    },
+}
+app.get("/api-docs/swagger.json", (req, res) => res.json(swaggerDocument));
+app.use('/api-docs', swaggerUi.serveFiles(null, options), swaggerUi.setup(null, options));
+```
+
+
+## Requirements
+
+* Node v0.10.32 or above
+* Express 4 or above
+
+## Testing
+
+* Install phantom
+* `npm install`
+* `npm test`

package/node_modules/swagger-ui-express/index.js

@@ -0,0 +1,311 @@
+'use strict'
+
+var express = require('express')
+var getAbsoluteSwaggerFsPath = require('swagger-ui-dist/absolute-path')
+var favIconHtml = '<link rel="icon" type="image/png" href="./favicon-32x32.png" sizes="32x32" />' +
+  '<link rel="icon" type="image/png" href="./favicon-16x16.png" sizes="16x16" />'
+var swaggerInit = ''
+
+function trimQuery(q) {
+  return q && q.split('?')[0]
+}
+
+var htmlTplString = `
+<!-- HTML for static distribution bundle build -->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <% robotsMetaString %>
+  <title><% title %></title>
+  <link rel="stylesheet" type="text/css" href="./swagger-ui.css" >
+  <% favIconString %>
+  <style>
+    html
+    {
+      box-sizing: border-box;
+      overflow: -moz-scrollbars-vertical;
+      overflow-y: scroll;
+    }
+    *,
+    *:before,
+    *:after
+    {
+      box-sizing: inherit;
+    }
+
+    body {
+      margin:0;
+      background: #fafafa;
+    }
+  </style>
+</head>
+
+<body>
+
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="position:absolute;width:0;height:0">
+  <defs>
+    <symbol viewBox="0 0 20 20" id="unlocked">
+      <path d="M15.8 8H14V5.6C14 2.703 12.665 1 10 1 7.334 1 6 2.703 6 5.6V6h2v-.801C8 3.754 8.797 3 10 3c1.203 0 2 .754 2 2.199V8H4c-.553 0-1 .646-1 1.199V17c0 .549.428 1.139.951 1.307l1.197.387C5.672 18.861 6.55 19 7.1 19h5.8c.549 0 1.428-.139 1.951-.307l1.196-.387c.524-.167.953-.757.953-1.306V9.199C17 8.646 16.352 8 15.8 8z"></path>
+    </symbol>
+
+    <symbol viewBox="0 0 20 20" id="locked">
+      <path d="M15.8 8H14V5.6C14 2.703 12.665 1 10 1 7.334 1 6 2.703 6 5.6V8H4c-.553 0-1 .646-1 1.199V17c0 .549.428 1.139.951 1.307l1.197.387C5.672 18.861 6.55 19 7.1 19h5.8c.549 0 1.428-.139 1.951-.307l1.196-.387c.524-.167.953-.757.953-1.306V9.199C17 8.646 16.352 8 15.8 8zM12 8H8V5.199C8 3.754 8.797 3 10 3c1.203 0 2 .754 2 2.199V8z"/>
+    </symbol>
+
+    <symbol viewBox="0 0 20 20" id="close">
+      <path d="M14.348 14.849c-.469.469-1.229.469-1.697 0L10 11.819l-2.651 3.029c-.469.469-1.229.469-1.697 0-.469-.469-.469-1.229 0-1.697l2.758-3.15-2.759-3.152c-.469-.469-.469-1.228 0-1.697.469-.469 1.228-.469 1.697 0L10 8.183l2.651-3.031c.469-.469 1.228-.469 1.697 0 .469.469.469 1.229 0 1.697l-2.758 3.152 2.758 3.15c.469.469.469 1.229 0 1.698z"/>
+    </symbol>
+
+    <symbol viewBox="0 0 20 20" id="large-arrow">
+      <path d="M13.25 10L6.109 2.58c-.268-.27-.268-.707 0-.979.268-.27.701-.27.969 0l7.83 7.908c.268.271.268.709 0 .979l-7.83 7.908c-.268.271-.701.27-.969 0-.268-.269-.268-.707 0-.979L13.25 10z"/>
+    </symbol>
+
+    <symbol viewBox="0 0 20 20" id="large-arrow-down">
+      <path d="M17.418 6.109c.272-.268.709-.268.979 0s.271.701 0 .969l-7.908 7.83c-.27.268-.707.268-.979 0l-7.908-7.83c-.27-.268-.27-.701 0-.969.271-.268.709-.268.979 0L10 13.25l7.418-7.141z"/>
+    </symbol>
+
+
+    <symbol viewBox="0 0 24 24" id="jump-to">
+      <path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.41L5.83 13H21V7z"/>
+    </symbol>
+
+    <symbol viewBox="0 0 24 24" id="expand">
+      <path d="M10 18h4v-2h-4v2zM3 6v2h18V6H3zm3 7h12v-2H6v2z"/>
+    </symbol>
+
+  </defs>
+</svg>
+
+<div id="swagger-ui"></div>
+
+<script src="./swagger-ui-bundle.js"> </script>
+<script src="./swagger-ui-standalone-preset.js"> </script>
+<script src="./swagger-ui-init.js"> </script>
+<% customJs %>
+<% customJsStr %>
+<% customCssUrl %>
+<style>
+  <% customCss %>
+</style>
+</body>
+
+</html>
+`
+
+var jsTplString = `
+window.onload = function() {
+  // Build a system
+  var url = window.location.search.match(/url=([^&]+)/);
+  if (url && url.length > 1) {
+    url = decodeURIComponent(url[1]);
+  } else {
+    url = window.location.origin;
+  }
+  <% swaggerOptions %>
+  url = options.swaggerUrl || url
+  var urls = options.swaggerUrls
+  var customOptions = options.customOptions
+  var spec1 = options.swaggerDoc
+  var swaggerOptions = {
+    spec: spec1,
+    url: url,
+    urls: urls,
+    dom_id: '#swagger-ui',
+    deepLinking: true,
+    presets: [
+      SwaggerUIBundle.presets.apis,
+      SwaggerUIStandalonePreset
+    ],
+    plugins: [
+      SwaggerUIBundle.plugins.DownloadUrl
+    ],
+    layout: "StandaloneLayout"
+  }
+  for (var attrname in customOptions) {
+    swaggerOptions[attrname] = customOptions[attrname];
+  }
+  var ui = SwaggerUIBundle(swaggerOptions)
+
+  if (customOptions.oauth) {
+    ui.initOAuth(customOptions.oauth)
+  }
+
+  if (customOptions.preauthorizeApiKey) {
+    const key = customOptions.preauthorizeApiKey.authDefinitionKey;
+    const value = customOptions.preauthorizeApiKey.apiKeyValue;
+    if (!!key && !!value) {
+      const pid = setInterval(() => {
+        const authorized = ui.preauthorizeApiKey(key, value);
+        if(!!authorized) clearInterval(pid);
+      }, 500)
+
+    }
+  }
+
+  if (customOptions.authAction) {
+    ui.authActions.authorize(customOptions.authAction)
+  }
+
+  window.ui = ui
+}
+`
+
+function toExternalScriptTag(url) {
+  return `<script src='${url}'></script>`
+}
+
+function toInlineScriptTag(jsCode) {
+  return `<script>${jsCode}</script>`
+}
+
+function toExternalStylesheetTag(url) {
+  return `<link href='${url}' rel='stylesheet'>`
+}
+
+function toTags(customCode, toScript) {
+  if (typeof customCode === 'string') {
+    return toScript(customCode)
+  } else if (Array.isArray(customCode)) {
+    return customCode.map(toScript).join('\n')
+  } else {
+    return ''
+  }
+}
+
+var generateHTML = function (swaggerDoc, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle, _htmlTplString, _jsTplString) {
+  var isExplorer
+  var customJs
+  var customJsStr
+  var swaggerUrls
+  var customCssUrl
+  var customRobots
+  if (opts && typeof opts === 'object') {
+    options = opts.swaggerOptions
+    customCss = opts.customCss
+    customJs = opts.customJs
+    customJsStr = opts.customJsStr
+    customfavIcon = opts.customfavIcon
+    customRobots = opts.customRobots
+    swaggerUrl = opts.swaggerUrl
+    swaggerUrls = opts.swaggerUrls
+    isExplorer = opts.explorer || !!swaggerUrls
+    customSiteTitle = opts.customSiteTitle
+    customCssUrl = opts.customCssUrl
+  } else {
+    //support legacy params based function
+    isExplorer = opts
+  }
+  options = options || {}
+  var explorerString = isExplorer ? '' : '.swagger-ui .topbar .download-url-wrapper { display: none }'
+  customCss = explorerString + ' ' + customCss || explorerString
+  customfavIcon = customfavIcon || false
+  customSiteTitle = customSiteTitle || 'Swagger UI'
+  _htmlTplString = _htmlTplString || htmlTplString
+  _jsTplString = _jsTplString || jsTplString
+
+  var robotsMetaString = customRobots ? '<meta name="robots" content="' + customRobots + '" />' : ''
+  var favIconString = customfavIcon ? '<link rel="icon" href="' + customfavIcon + '" />' : favIconHtml
+  var htmlWithCustomCss = _htmlTplString.toString().replace('<% customCss %>', customCss)
+  var htmlWithCustomRobots = htmlWithCustomCss.replace('<% robotsMetaString %>', robotsMetaString)
+  var htmlWithFavIcon = htmlWithCustomRobots.replace('<% favIconString %>', favIconString)
+  var htmlWithCustomJsUrl = htmlWithFavIcon.replace('<% customJs %>', toTags(customJs, toExternalScriptTag))
+  var htmlWithCustomJs = htmlWithCustomJsUrl.replace('<% customJsStr %>', toTags(customJsStr, toInlineScriptTag))
+  var htmlWithCustomCssUrl = htmlWithCustomJs.replace('<% customCssUrl %>', toTags(customCssUrl, toExternalStylesheetTag))
+
+  var initOptions = {
+    swaggerDoc: swaggerDoc || undefined,
+    customOptions: options,
+    swaggerUrl: swaggerUrl || undefined,
+    swaggerUrls: swaggerUrls || undefined
+  }
+
+  swaggerInit = _jsTplString.toString().replace('<% swaggerOptions %>', stringify(initOptions))
+  return htmlWithCustomCssUrl.replace('<% title %>', customSiteTitle)
+}
+
+var setup = function (swaggerDoc, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle) {
+  var html = generateHTML(swaggerDoc, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle, htmlTplString, jsTplString)
+  return function (req, res) {
+    if (req.swaggerDoc) {
+      var reqHtml = generateHTML(req.swaggerDoc, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle, htmlTplString, jsTplString)
+      res.send(reqHtml)
+    } else {
+      res.send(html)
+    }
+  }
+}
+
+function swaggerInitFn(req, res, next) {
+  if (trimQuery(req.url).endsWith('/package.json')) {
+    res.sendStatus(404)
+  } else if (trimQuery(req.url).endsWith('/swagger-ui-init.js')) {
+    res.set('Content-Type', 'application/javascript')
+    res.send(swaggerInit)
+  } else {
+    next()
+  }
+}
+
+var swaggerInitFunction = function (swaggerDoc, opts) {
+  var swaggerInitFile = jsTplString.toString().replace('<% swaggerOptions %>', stringify(opts))
+  return function (req, res, next) {
+    if (trimQuery(req.url).endsWith('/package.json')) {
+      res.sendStatus(404)
+    } else if (trimQuery(req.url).endsWith('/swagger-ui-init.js')) {
+      if (req.swaggerDoc) {
+        opts.swaggerDoc = req.swaggerDoc
+        swaggerInitFile = jsTplString.toString().replace('<% swaggerOptions %>', stringify(opts))
+      }
+      res.set('Content-Type', 'application/javascript')
+      res.send(swaggerInitFile)
+    } else {
+      next()
+    }
+  }
+}
+
+var swaggerAssetMiddleware = options => {
+  var opts = options || {}
+  opts.index = false
+  return express.static(getAbsoluteSwaggerFsPath(), opts)
+}
+
+var serveFiles = function (swaggerDoc, opts) {
+  opts = opts || {}
+  var initOptions = {
+    swaggerDoc: swaggerDoc || undefined,
+    customOptions: opts.swaggerOptions || {},
+    swaggerUrl: opts.swaggerUrl || {},
+    swaggerUrls: opts.swaggerUrls || undefined
+  }
+  var swaggerInitWithOpts = swaggerInitFunction(swaggerDoc, initOptions)
+  return [swaggerInitWithOpts, swaggerAssetMiddleware()]
+}
+
+var serve = [swaggerInitFn, swaggerAssetMiddleware()]
+var serveWithOptions = options => [swaggerInitFn, swaggerAssetMiddleware(options)]
+
+var stringify = function (obj, prop) {
+  var placeholder = '____FUNCTIONPLACEHOLDER____'
+  var fns = []
+  var json = JSON.stringify(obj, function (key, value) {
+    if (typeof value === 'function') {
+      fns.push(value)
+      return placeholder
+    }
+    return value
+  }, 2)
+  json = json.replace(new RegExp('"' + placeholder + '"', 'g'), function (_) {
+    return fns.shift()
+  })
+  return 'var options = ' + json + ';'
+}
+
+module.exports = {
+  setup: setup,
+  serve: serve,
+  serveWithOptions: serveWithOptions,
+  generateHTML: generateHTML,
+  serveFiles: serveFiles
+}