feat: application configuration completed flag.

server/src/api/controllers/Settings.ts

@@ -1,9 +1,13 @@
 import { Router, Request, Response } from 'express';
-import { body, query, validationResult } from 'express-validator';
+import { body, query } from 'express-validator';
 import { pick } from 'lodash';
 import { IOptionDTO, IOptionsDTO } from 'interfaces';
 import BaseController from 'api/controllers/BaseController';
 import asyncMiddleware from 'api/middleware/asyncMiddleware';
+import {
+  getDefinedOptions,
+  isDefinedOptionConfigurable,
+} from 'utils';
 
 export default  class SettingsController extends BaseController{
   /**
@@ -14,12 +18,14 @@ export default  class SettingsController extends BaseController{
 
     router.post('/',
       this.saveSettingsValidationSchema,
-      asyncMiddleware(this.saveSettings.bind(this)));
-
+      this.validationResult,
+      asyncMiddleware(this.saveSettings.bind(this)),
+    );
     router.get('/',
       this.getSettingsSchema,
-      asyncMiddleware(this.getSettings.bind(this)));
-
+      this.validationResult,
+      asyncMiddleware(this.getSettings.bind(this)),
+    );
     return router;
   }
 
@@ -29,9 +35,9 @@ export default  class SettingsController extends BaseController{
   get saveSettingsValidationSchema() {
     return [
       body('options').isArray({ min: 1 }),
-      body('options.*.key').exists(),
-      body('options.*.value').exists(),
-      body('options.*.group').exists(),
+      body('options.*.key').exists().trim().escape().isLength({ min: 1 }),
+      body('options.*.value').exists().trim().escape().isLength({ min: 1 }),
+      body('options.*.group').exists().trim().escape().isLength({ min: 1 }),
     ];
   }
 
@@ -40,11 +46,32 @@ export default  class SettingsController extends BaseController{
    */
   get getSettingsSchema() {
     return [
-      query('key').optional(),
-      query('group').optional(),
+      query('key').optional().trim().escape(),
+      query('group').optional().trim().escape(),
     ];
   }
 
+  /**
+   * Observes application configuration option, whether all options configured
+   * sets `app_configured` option.
+   * @param {Setting} settings 
+   */
+  observeAppConfigsComplete(settings) {
+    if (!settings.get('app_configured', false)) {
+      const definedOptions = getDefinedOptions();
+
+      const isNotConfigured = definedOptions.some((option) => {
+        const isDefined = isDefinedOptionConfigurable(option.key, option.group);
+        const hasStoredOption = settings.get({ key: option.key, group: option.group });
+
+        return (isDefined && !hasStoredOption);
+      });
+      if (!isNotConfigured) {
+        settings.set('app_configured', true);
+      }
+    }
+  }
+
   /**
    * Saves the given options to the storage.
    * @param {Request} req - 
@@ -71,7 +98,8 @@ export default  class SettingsController extends BaseController{
     optionsDTO.options.forEach((option: IOptionDTO) => {
       settings.set({ ...option });
     });
- 
+    this.observeAppConfigsComplete(settings);
+
     return res.status(200).send({ 
       type: 'success',
       code: 'OPTIONS.SAVED.SUCCESSFULLY',

server/src/api/index.ts

@@ -41,6 +41,8 @@ import Licenses from 'api/controllers/Subscription/Licenses';
 export default () => {
   const app = Router();
 
+  // - Global routes.
+  // ---------------------------
   app.use(I18nMiddleware);
 
   app.use('/auth', Container.get(Authentication).router());
@@ -49,7 +51,24 @@ export default () => {
   app.use('/subscription', Container.get(Subscription).router());
   app.use('/ping', Container.get(Ping).router());
   app.use('/organization', Container.get(Organization).router());
+  
+  // - Settings routes.
+  // ---------------------------
+  const settings = Router();
 
+  settings.use(JWTAuth);
+  settings.use(AttachCurrentTenantUser);
+  settings.use(TenancyMiddleware);
+  settings.use(SubscriptionMiddleware('main'));
+  settings.use(EnsureTenantIsInitialized);
+  settings.use(SettingsMiddleware);
+
+  settings.use('/settings', Container.get(Settings).router());
+
+  app.use('/', settings);
+
+  // - Dashboard routes.
+  // ---------------------------
   const dashboard = Router();
 
   dashboard.use(JWTAuth);
@@ -73,7 +92,6 @@ export default () => {
   dashboard.use('/item_categories', Container.get(ItemCategories).router());
   dashboard.use('/expenses', Container.get(Expenses).router());
   dashboard.use('/financial_statements', FinancialStatements.router());
-  dashboard.use('/settings', Container.get(Settings).router());
   dashboard.use('/sales', Sales.router());
   dashboard.use('/customers', Container.get(Customers).router());
   dashboard.use('/vendors', Container.get(Vendors).router());