@strapi/plugin-documentation 0.0.0-experimental.62ebf57bb35846666febb5ee2078fe02fe990f57 → 0.0.0-experimental.6340da17068c3bed7fb006e7bcc554c71129e282

package/packup.config.ts

@@ -1,22 +0,0 @@
-import { Config, defineConfig } from '@strapi/pack-up';
-import { transformWithEsbuild } from 'vite';
-
-const config: Config = defineConfig({
-  bundles: [
-    {
-      source: './admin/src/index.js',
-      import: './dist/admin/index.mjs',
-      require: './dist/admin/index.js',
-      runtime: 'web',
-    },
-  ],
-  dist: './dist',
-  /**
-   * Because we're exporting a server & client package
-   * which have different runtimes we want to ignore
-   * what they look like in the package.json
-   */
-  exports: {},
-});
-
-export default config;

package/server/bootstrap.js

@@ -1,54 +0,0 @@
-/* eslint-disable no-unreachable */
-
-'use strict';
-
-// Add permissions
-const RBAC_ACTIONS = [
-  {
-    section: 'plugins',
-    displayName: 'Access the Documentation',
-    uid: 'read',
-    pluginName: 'documentation',
-  },
-  {
-    section: 'plugins',
-    displayName: 'Update and delete',
-    uid: 'settings.update',
-    pluginName: 'documentation',
-  },
-  {
-    section: 'plugins',
-    displayName: 'Regenerate',
-    uid: 'settings.regenerate',
-    pluginName: 'documentation',
-  },
-  {
-    section: 'settings',
-    displayName: 'Access the documentation settings page',
-    uid: 'settings.read',
-    pluginName: 'documentation',
-    category: 'documentation',
-  },
-];
-
-/**
- *
- * @param {{strapi: import("@strapi/strapi").Strapi}} args
- */
-module.exports = async ({ strapi }) => {
-  await strapi.admin.services.permission.actionProvider.registerMany(RBAC_ACTIONS);
-
-  const pluginStore = strapi.store({
-    environment: '',
-    type: 'plugin',
-    name: 'documentation',
-  });
-
-  const config = await pluginStore.get({ key: 'config' });
-
-  if (!config) {
-    pluginStore.set({ key: 'config', value: { restrictedAccess: false } });
-  }
-
-  await strapi.plugin('documentation').service('documentation').generateFullDoc();
-};

package/server/config/default-plugin-config.js

@@ -1,35 +0,0 @@
-'use strict';
-
-module.exports = {
-  openapi: '3.0.0',
-  info: {
-    version: '1.0.0',
-    title: 'DOCUMENTATION',
-    description: '',
-    termsOfService: 'YOUR_TERMS_OF_SERVICE_URL',
-    contact: {
-      name: 'TEAM',
-      email: 'contact-email@something.io',
-      url: 'mywebsite.io',
-    },
-    license: {
-      name: 'Apache 2.0',
-      url: 'https://www.apache.org/licenses/LICENSE-2.0.html',
-    },
-  },
-  'x-strapi-config': {
-    path: '/documentation',
-    plugins: null,
-    mutateDocumentation: null,
-  },
-  servers: [],
-  externalDocs: {
-    description: 'Find out more',
-    url: 'https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html',
-  },
-  security: [
-    {
-      bearerAuth: [],
-    },
-  ],
-};

package/server/config/index.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const defaultPluginConfig = require('./default-plugin-config');
-
-module.exports = {
-  default: defaultPluginConfig,
-};

package/server/controllers/documentation.js

@@ -1,241 +0,0 @@
-'use strict';
-
-/**
- * Documentation.js controller
- *
- * @description: A set of functions called "actions" of the `documentation` plugin.
- */
-
-// Core dependencies.
-const path = require('path');
-const bcrypt = require('bcryptjs');
-
-// Public dependencies.
-const fs = require('fs-extra');
-const _ = require('lodash');
-const koaStatic = require('koa-static');
-
-module.exports = {
-  async getInfos(ctx) {
-    try {
-      const docService = strapi.plugin('documentation').service('documentation');
-      const docVersions = docService.getDocumentationVersions();
-      const documentationAccess = await docService.getDocumentationAccess();
-
-      ctx.send({
-        docVersions,
-        currentVersion: docService.getDocumentationVersion(),
-        prefix: strapi.plugin('documentation').config('x-strapi-config').path,
-        documentationAccess,
-      });
-    } catch (err) {
-      ctx.badRequest(null, err.message);
-    }
-  },
-
-  async index(ctx, next) {
-    try {
-      /**
-       * We don't expose the specs using koa-static or something else due to security reasons.
-       * That's why, we need to read the file localy and send the specs through it when we serve the Swagger UI.
-       */
-      const { major, minor, patch } = ctx.params;
-      const version =
-        major && minor && patch
-          ? `${major}.${minor}.${patch}`
-          : strapi.plugin('documentation').service('documentation').getDocumentationVersion();
-
-      const openAPISpecsPath = path.join(
-        strapi.dirs.app.extensions,
-        'documentation',
-        'documentation',
-        version,
-        'full_documentation.json'
-      );
-
-      try {
-        const documentation = fs.readFileSync(openAPISpecsPath, 'utf8');
-        const layout = fs.readFileSync(
-          path.resolve(__dirname, '..', 'public', 'index.html'),
-          'utf8'
-        );
-        const filledLayout = _.template(layout)({
-          backendUrl: strapi.config.server.url,
-          spec: JSON.stringify(JSON.parse(documentation)),
-        });
-
-        try {
-          const layoutPath = path.resolve(
-            strapi.dirs.app.extensions,
-            'documentation',
-            'public',
-            'index.html'
-          );
-          await fs.ensureFile(layoutPath);
-          await fs.writeFile(layoutPath, filledLayout);
-
-          // Serve the file.
-          ctx.url = path.basename(`${ctx.url}/index.html`);
-
-          try {
-            const staticFolder = path.resolve(
-              strapi.dirs.app.extensions,
-              'documentation',
-              'public'
-            );
-            return koaStatic(staticFolder)(ctx, next);
-          } catch (e) {
-            strapi.log.error(e);
-          }
-        } catch (e) {
-          strapi.log.error(e);
-        }
-      } catch (e) {
-        strapi.log.error(e);
-      }
-    } catch (e) {
-      strapi.log.error(e);
-    }
-  },
-
-  async loginView(ctx, next) {
-    // lazy require cheerio
-    const cheerio = require('cheerio');
-
-    const { error } = ctx.query;
-
-    try {
-      const layout = fs.readFileSync(path.join(__dirname, '..', 'public', 'login.html'));
-      const filledLayout = _.template(layout)({
-        actionUrl: `${strapi.config.server.url}${
-          strapi.config.get('plugin.documentation.x-strapi-config').path
-        }/login`,
-      });
-      const $ = cheerio.load(filledLayout);
-
-      $('.error').text(_.isEmpty(error) ? '' : 'Wrong password...');
-
-      try {
-        const layoutPath = path.resolve(
-          strapi.dirs.app.extensions,
-          'documentation',
-          'public',
-          'login.html'
-        );
-        await fs.ensureFile(layoutPath);
-        await fs.writeFile(layoutPath, $.html());
-
-        ctx.url = path.basename(`${ctx.url}/login.html`);
-
-        try {
-          const staticFolder = path.resolve(strapi.dirs.app.extensions, 'documentation', 'public');
-          return koaStatic(staticFolder)(ctx, next);
-        } catch (e) {
-          strapi.log.error(e);
-        }
-      } catch (e) {
-        strapi.log.error(e);
-      }
-    } catch (e) {
-      strapi.log.error(e);
-    }
-  },
-
-  async login(ctx) {
-    const {
-      body: { password },
-    } = ctx.request;
-
-    const { password: hash } = await strapi
-      .store({ type: 'plugin', name: 'documentation', key: 'config' })
-      .get();
-
-    const isValid = await bcrypt.compare(password, hash);
-
-    let querystring = '?error=password';
-
-    if (isValid) {
-      ctx.session.documentation = {
-        logged: true,
-      };
-
-      querystring = '';
-    }
-
-    ctx.redirect(
-      `${strapi.config.server.url}${
-        strapi.config.get('plugin.documentation.x-strapi-config').path
-      }${querystring}`
-    );
-  },
-
-  async regenerateDoc(ctx) {
-    const { version } = ctx.request.body;
-
-    const service = strapi.service('plugin::documentation.documentation');
-
-    const documentationVersions = service.getDocumentationVersions().map((el) => el.version);
-
-    if (_.isEmpty(version)) {
-      return ctx.badRequest('Please provide a version.');
-    }
-
-    if (!documentationVersions.includes(version)) {
-      return ctx.badRequest('The version you are trying to generate does not exist.');
-    }
-
-    try {
-      strapi.reload.isWatching = false;
-      await service.generateFullDoc(version);
-      ctx.send({ ok: true });
-    } finally {
-      strapi.reload.isWatching = true;
-    }
-  },
-
-  async deleteDoc(ctx) {
-    const { version } = ctx.params;
-
-    const service = strapi.service('plugin::documentation.documentation');
-
-    const documentationVersions = service.getDocumentationVersions().map((el) => el.version);
-
-    if (_.isEmpty(version)) {
-      return ctx.badRequest('Please provide a version.');
-    }
-
-    if (!documentationVersions.includes(version)) {
-      return ctx.badRequest('The version you are trying to delete does not exist.');
-    }
-
-    try {
-      strapi.reload.isWatching = false;
-      await service.deleteDocumentation(version);
-      ctx.send({ ok: true });
-    } finally {
-      strapi.reload.isWatching = true;
-    }
-  },
-
-  async updateSettings(ctx) {
-    const { restrictedAccess, password } = ctx.request.body;
-
-    const pluginStore = strapi.store({ type: 'plugin', name: 'documentation' });
-
-    const config = {
-      restrictedAccess: Boolean(restrictedAccess),
-    };
-
-    if (restrictedAccess) {
-      if (_.isEmpty(password)) {
-        return ctx.badRequest('Please provide a password');
-      }
-
-      config.password = await bcrypt.hash(password, 10);
-    }
-
-    await pluginStore.set({ key: 'config', value: config });
-
-    return ctx.send({ ok: true });
-  },
-};

package/server/controllers/index.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const documentation = require('./documentation');
-
-module.exports = {
-  documentation,
-};

package/server/index.js

@@ -1,17 +0,0 @@
-'use strict';
-
-const bootstrap = require('./bootstrap');
-const services = require('./services');
-const routes = require('./routes');
-const controllers = require('./controllers');
-const register = require('./register');
-const config = require('./config');
-
-module.exports = () => ({
-  bootstrap,
-  config,
-  routes,
-  controllers,
-  register,
-  services,
-});

package/server/middlewares/documentation.js

@@ -1,25 +0,0 @@
-'use strict';
-
-const path = require('path');
-const koaStatic = require('koa-static');
-const swaggerUi = require('swagger-ui-dist');
-
-module.exports = async ({ strapi }) => {
-  strapi.server.routes([
-    {
-      method: 'GET',
-      path: '/plugins/documentation/(.*)',
-      async handler(ctx, next) {
-        ctx.url = path.basename(ctx.url);
-
-        return koaStatic(swaggerUi.getAbsoluteFSPath(), {
-          maxage: 86400000,
-          defer: true,
-        })(ctx, next);
-      },
-      config: {
-        auth: false,
-      },
-    },
-  ]);
-};

package/server/middlewares/index.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const documentation = require('./documentation');
-
-module.exports = {
-  documentation,
-};

package/server/middlewares/restrict-access.js

@@ -1,24 +0,0 @@
-'use strict';
-
-module.exports = async (ctx, next) => {
-  const pluginStore = strapi.store({ type: 'plugin', name: 'documentation' });
-
-  const config = await pluginStore.get({ key: 'config' });
-
-  if (!config.restrictedAccess) {
-    return next();
-  }
-
-  if (!ctx.session.documentation || !ctx.session.documentation.logged) {
-    const querystring = ctx.querystring ? `?${ctx.querystring}` : '';
-
-    return ctx.redirect(
-      `${strapi.config.server.url}${
-        strapi.config.get('plugin.documentation.x-strapi-config').path
-      }/login${querystring}`
-    );
-  }
-
-  // Execute the action.
-  return next();
-};

package/server/public/index.html

@@ -1,70 +0,0 @@
-<!-- HTML for static distribution bundle build --><!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <title>Swagger UI</title>
-    <link
-      rel="stylesheet"
-      type="text/css"
-      href="<%=backendUrl%>/plugins/documentation/swagger-ui.css"
-    />
-    <link
-      rel="icon"
-      type="image/png"
-      href="<%=backendUrl%>/plugins/documentation/favicon-32x32.png"
-      sizes="32x32"
-    />
-    <link
-      rel="icon"
-      type="image/png"
-      href="<%=backendUrl%>/plugins/documentation/favicon-16x16.png"
-      sizes="16x16"
-    />
-    <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>
-    <div id="swagger-ui"></div>
-    <script class="custom-swagger-ui">
-      window.onload = function() {
-        const ui = SwaggerUIBundle({
-          url: "https://petstore.swagger.io/v2/swagger.json",
-          spec: <%=spec%>,
-          dom_id: '#swagger-ui',
-          docExpansion: "none",
-          deepLinking: true,
-          presets: [
-            SwaggerUIBundle.presets.apis,
-            SwaggerUIStandalonePreset,
-          ],
-          plugins: [
-            SwaggerUIBundle.plugins.DownloadUrl,
-          ],
-          layout: "StandaloneLayout",
-        });
-
-        window.ui = ui;
-      }
-    </script>
-
-    <script src="<%=backendUrl%>/plugins/documentation/swagger-ui-bundle.js"></script>
-    <script src="<%=backendUrl%>/plugins/documentation/swagger-ui-standalone-preset.js"></script>
-  </body>
-</html>

package/server/public/login.html

@@ -1,145 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>Login - Documentation</title>
-    <link href="https://fonts.googleapis.com/css?family=Lato:400,700" rel="stylesheet" />
-    <style>
-      html {
-        font-size: 62.5%;
-        height: 100%;
-        margin: 0;
-        padding: 0;
-      }
-
-      body {
-        height: 100%;
-        margin: 0;
-        background-color: #ffffff;
-        font-family: 'Lato';
-        font-size: 1.4rem;
-        font-weight: 400;
-        text-rendering: optimizeLegibility;
-        -webkit-font-smoothing: antialiased;
-        -moz-osx-font-smoothing: grayscale;
-      }
-
-      .login {
-        height: 100%;
-        background-color: #f6f9fc;
-      }
-
-      .login .login-form {
-        height: calc(100% - 70px);
-        padding: 68px 0 0;
-        text-align: center;
-      }
-
-      .login .login-form form {
-        position: relative;
-        max-width: 460px;
-        padding: 26px 30px;
-        margin: 55px auto 0;
-        background-color: #ffffff;
-        border-radius: 3px;
-        box-shadow: 0px 2px 4px rgba(91, 107, 174, 0.15);
-        text-align: center;
-      }
-
-      .login .login-form form:before {
-        position: absolute;
-        content: '';
-        top: 0px;
-        left: 0;
-        display: inline-block;
-        width: 100%;
-        height: 2px;
-        background-color: #2b66cc;
-      }
-
-      .login .login-form form .error {
-        display: block;
-        color: #ff4e00;
-        padding-bottom: 20px;
-      }
-
-      .login .login-form .sub-title {
-        margin-top: 35px;
-        font-size: 1.6rem;
-        font-weight: 400;
-      }
-
-      .login .login-form .logo {
-        max-height: 40px;
-      }
-
-      .login .login-form form label {
-        display: block;
-        margin-bottom: 18px;
-        width: 100%;
-        text-align: left;
-        font-weight: 600;
-      }
-
-      .login .login-form form input {
-        outline: none;
-        width: calc(100% - 30px);
-        height: 36px;
-        padding: 0 15px;
-        border: 1px solid #ececec;
-        border-radius: 2px;
-        margin-bottom: 20px;
-        line-height: 36px;
-        text-align: left;
-      }
-
-      .login .login-form form input[type='submit'] {
-        cursor: pointer;
-        display: inline-block;
-        width: auto;
-        margin: 12px auto 0;
-        padding: 0 75px;
-        background: transparent;
-        border-radius: 36px;
-        border: 1px solid #2b66cc;
-        color: #2b66cc;
-        text-transform: uppercase;
-        font-size: 1.4rem;
-        font-weight: 700;
-        transition: all 0.2s ease-out;
-      }
-
-      .login .login-form form input[type='submit']:hover {
-        background: #2b66cc;
-        color: #ffffff;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="login">
-      <section class="login-form">
-        <div class="container">
-          <div class="row">
-            <div class="col-lg-6 col-lg-offset-3 col-md-12">
-              <img
-                alt="Strapi logo"
-                class="logo"
-                src="https://strapi.io/assets/images/logo_login.png"
-              />
-              <h2 class="sub-title">Enter the password to access the documentation.</h2>
-              <form method="post" action="<%=actionUrl%>">
-                <span class="error">Wrong password...</span>
-                <label>Password</label>
-                <input
-                  type="password"
-                  name="password"
-                  placeholder="&#x2022;&#x2022;&#x2022;&#x2022;&#x2022;&#x2022;&#x2022;&#x2022;&#x2022;"
-                />
-                <input type="submit" value="Login" />
-              </form>
-            </div>
-          </div>
-        </div>
-      </section>
-    </div>
-  </body>
-</html>

package/server/register.js

@@ -1,11 +0,0 @@
-'use strict';
-
-const registerDocumentationMiddleWare = require('./middlewares/documentation');
-
-/**
- * Register upload plugin
- * @param {{ strapi: import('@strapi/strapi').Strapi }}
- */
-module.exports = async ({ strapi }) => {
-  await registerDocumentationMiddleWare({ strapi });
-};