miolo 3.0.0-beta.21 → 3.0.0-beta.210

package/src/config/defaults.mjs

@@ -1,6 +1,7 @@
-import path from 'path'
-const SESSION_MAX_AGE = 86400 * 10 * 1000
+import path from "node:path"
 
+const SESSION_MAX_AGE = 86400 * 10 * 1000
+const root = (dir) => path.resolve(process.cwd(), dir)
 
 //
 // Notice `miolo` has support for `.env` files
@@ -8,124 +9,144 @@ const SESSION_MAX_AGE = 86400 * 10 * 1000
 // and set the variables you want to use.
 // Then you can configure miolo using process.env.WHATEVER.
 
-
 export default function make_config_defaults() {
-  
   return {
-    name: process.env.MIOLO_NAME || 'miolo',
+    name: process.env.MIOLO_NAME || "miolo",
     http: {
       port: process.env?.MIOLO_PORT || 8001,
-      hostname: process.env?.IS_DOCKER === "true" 
-        ? '0.0.0.0' 
-        : process.env?.MIOLO_HOSTNAME || 'localhost',
+      hostname:
+        process.env?.IS_DOCKER === "true"
+          ? process.env?.MIOLO_HOSTNAME_DOCKER || "0.0.0.0"
+          : process.env?.MIOLO_HOSTNAME || "localhost",
+
+      ssl: undefined,
+      //ssl: {
+      //    key: fs.readFileSync('.../key.pem'),
+      //    cert: fs.readFileSync('.../cert.pem'),
+      // }
+
+      catcher_url: "/sys/jserror",
 
-      catcher_url: '/sys/jserror',
-      
       static: {
-        favicon: '',
-        folders: {}
+        favicon: root("src/static/img/favicon.ico"),
+        headers: {
+          "/sw.js": {
+            "Cache-Control": "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0"
+          }
+          //"/index.html": { "Cache-Control": "no-cache, max-age=0" },
+          //"/": { "Cache-Control": "no-cache, max-age=0" }
+        },
+        folders: {
+          "/build": root("build"),
+          "/static": root("src/static"),
+          "/": root("src/static/public")
+        }
       },
-      
+
       // cors can be:
       //   - false
       //   - simple    (just assign Access-Control-Allow-Origin='*' and Access-Control-Expose-Headers='SourceMap,X-SourceMap'
       //   - true      enable @koa/cors
       //   - {options} enable @koa/cors and use the custom options
       //
-      cors: process.env.MIOLO_HTTP_CORS==='true'
-        ? true
-        : process.env.MIOLO_HTTP_CORS==='simple'
-        ? 'simple'
-        : false,
+      cors:
+        process.env.MIOLO_HTTP_CORS === "true"
+          ? true
+          : process.env.MIOLO_HTTP_CORS === "simple"
+            ? "simple"
+            : false,
 
       // proxy can be:
       //   - false
       //   - true      enable koa-proxies and use default options
       //   - {options} enable koa-proxies and use the custom options
-      proxy: process.env.MIOLO_HTTP_PROXY==='true',
+      proxy: process.env.MIOLO_HTTP_PROXY === "true",
 
       ratelimit: {
-        /* eslint-disable no-unused-vars */
-        max: parseInt(process.env.MIOLO_RATELIMIT_MAX || 1000),
-        duration: parseInt(process.env.MIOLO_RATELIMIT_DURATION || 60 * 1000), // miliseconds
-        errorMessage: 'Rate Limit reached',      
+        max: parseInt(process.env.MIOLO_RATELIMIT_MAX || 1000, 10),
+        duration: parseInt(process.env.MIOLO_RATELIMIT_DURATION || 60 * 1000, 10), // miliseconds
+        errorMessage: "Rate Limit reached",
         //whitelist: (ctx) => false,
         //blacklist: (ctx) => false,
-        whitelist_ips: process.env.MIOLO_RATELIMIT_WHITELIST_IPS?.split(',') || [],
-        blacklist_ips: process.env.MIOLO_RATELIMIT_BLACKLIST_IPS?.split(',') || [],
-        ipsum_folder: '/var/ipsum' // https://github.com/stamparm/ipsum
+        whitelist_ips: process.env.MIOLO_RATELIMIT_WHITELIST_IPS?.split(",") || [],
+        blacklist_ips: process.env.MIOLO_RATELIMIT_BLACKLIST_IPS?.split(",") || [],
+        ipsum_folder: "/var/ipsum" // https://github.com/stamparm/ipsum
       },
 
       request: {
-        lazy: parseInt(process.env.MIOLO_REQUEST_LAZY || 1), // seconds to consider lazy a request
-        slow: parseInt(process.env.MIOLO_REQUEST_SLOW || 2), // seconds to consider slow a request
+        lazy: parseInt(process.env.MIOLO_REQUEST_LAZY || 1, 10), // seconds to consider lazy a request
+        slow: parseInt(process.env.MIOLO_REQUEST_SLOW || 2, 10), // seconds to consider slow a request
         onStart: undefined,
         // (ctx, times) => { return begin_result}
         onDone: undefined,
         // (ctx, begin_result, times) => {},
         geoip: {
-          enabled: process.env.MIOLO_GEOIP_ENABLED==='true',
+          enabled: process.env.MIOLO_GEOIP_ENABLED === "true",
           db: process.env.MIOLO_GEOIP_DB,
-          local_ips: process.env.MIOLO_GEOIP_LOCAL_IPS?.split(',') || [
-            '127.0.0.1'
-          ]
+          local_ips: process.env.MIOLO_GEOIP_LOCAL_IPS?.split(",") || ["127.0.0.1"]
         }
       }
-      
     },
     session: {
-      salt: process.env.MIOLO_SESSION_SALT || 'SUPER_SALTY_YES?',
-      secret: process.env.MIOLO_SESSION_SECRET || 'SUPER_SECRET_KEY_KERE',
+      salt: process.env.MIOLO_SESSION_SALT || "SUPER_SALTY_YES?",
+      secret: process.env.MIOLO_SESSION_SECRET || "SUPER_SECRET_KEY_KERE",
       options: {
+        /** (string) cookie key (default is koa.sess) */
+        key: process.env.MIOLO_SESSION_KEY || `${process.env.MIOLO_NAME || "koa"}.sess`,
         /** (number || 'session') maxAge in ms (default is 1 days) */
         /** 'session' will result in a cookie that expires when session/browser is closed */
         /** Warning: If a session cookie is stolen, this cookie will never expire */
-        maxAge: parseInt(process.env.MIOLO_SESSION_MAX_AGE || SESSION_MAX_AGE),
-        
+        maxAge: parseInt(process.env.MIOLO_SESSION_MAX_AGE || SESSION_MAX_AGE, 10),
+
         /** (boolean) automatically commit headers (default true) */
-        //autoCommit: true, 
-        
+        //autoCommit: true,
+
         /** (boolean) can overwrite or not (default true) */
-        //overwrite: true, 
-        
+        //overwrite: true,
+
         /** (boolean) httpOnly or not (default true) */
-        //httpOnly: true, 
-        
+        //httpOnly: true,
+
         /** (boolean) signed or not (default true) */
-        //signed: true, 
-        
+        //signed: true,
+
         /** (boolean) Force a session identifier cookie to be set on every response. The expiration is reset to the original maxAge, resetting the expiration countdown. (default is false) */
-        //rolling: false, 
-        
+        //rolling: false,
+
         /** (boolean) renew session when session is nearly expired, so we can always keep user logged in. (default is false)*/
-        //renew: false, 
+        renew: process.env?.MIOLO_SESSION_RENEW === "true",
 
         /** (boolean) secure cookie*/
         /** You may want to set it as true in your Production environement,
          *  while false at DEV time.
          */
-        secure: process.env?.MIOLO_SESSION_SECURE === 'true',
-        
+        secure: process.env?.MIOLO_SESSION_SECURE === "true",
+
         /** (string) session cookie sameSite options (default null, don't set it) */
-        sameSite: 'lax', // 'strict', 
+        /** NOTE: Google Auth requires 'lax'  */
+        sameSite: process.env.MIOLO_SESSION_SAME_SITE || "lax" // 'strict',
       }
     },
     db: {
       config: {
-          dialect:  process.env.MIOLO_DB_DIALECT || 'postgres',
-          host:     process.env.MIOLO_DB_HOST || 'localhost',
-          port:     process.env.MIOLO_DB_PORT || 5432,
-          database: process.env.MIOLO_DB_DATABASE || 'miolo',
-          user:     process.env.MIOLO_DB_USER || 'postgres',
-          password: process.env.MIOLO_DB_PASSWORD || 'postgres',
-          // Maximum number of connection in pool
-          max:      parseInt(process.env.MIOLO_DB_POOL_MAX || 5),
-          // Minimum number of connection in pool
-          min:      parseInt(process.env.MIOLO_DB_POOL_MIN || 0),
-          // The maximum time, in milliseconds, that a connection can be idle before being released. 
-          // Use with combination of evict for proper working,
-          //   for more details read https://github.com/coopernurse/node-pool/issues/178#issuecomment-327110870,
-          idleTimeoutMillis: parseInt(process.env.MIOLO_DB_POOL_IDLE_TIMEOUT_MS || 10000), 
+        dialect: process.env.MIOLO_DB_DIALECT || "postgres",
+        host:
+          process.env?.IS_DOCKER === "true"
+            ? process.env.MIOLO_DB_DOCKER_HOST || "postgres"
+            : process.env.MIOLO_DB_HOST || "localhost",
+        port: process.env.MIOLO_DB_PORT || 5432,
+        database: process.env.MIOLO_DB_DATABASE,
+        filename: process.env.MIOLO_DB_FILENAME,
+        user: process.env.MIOLO_DB_USER,
+        password: process.env.MIOLO_DB_PASSWORD,
+        // Maximum number of connection in pool
+        max: parseInt(process.env.MIOLO_DB_POOL_MAX || 5, 10),
+        // Minimum number of connection in pool
+        min: parseInt(process.env.MIOLO_DB_POOL_MIN || 0, 10),
+        // The maximum time, in milliseconds, that a connection can be idle before being released.
+        // Use with combination of evict for proper working,
+        //   for more details read https://github.com/coopernurse/node-pool/issues/178#issuecomment-327110870,
+        idleTimeoutMillis: parseInt(process.env.MIOLO_DB_POOL_IDLE_TIMEOUT_MS || 10000, 10)
       },
       options: {
         tables: []
@@ -133,28 +154,32 @@ export default function make_config_defaults() {
         // cache:
         // Refer to top level cache option
         // cache: {...}
-        
+
         // log:
         // We will pass, on the fly, miolo logger to calustra
         // But specifying a level here, we can customize the level only for db/calustra actions
-        // log: 'silly', 
+        // log: 'silly',
       }
     },
     routes: {
       bodyField: undefined,
-    
+
       // auth: {
       //   require: false,     // true / false / 'read-only'
       //   action: 'redirect', // 'error'
       //   redirect_url: '/',
       //   error_code: 401
-      // }, 
+      // },
       // before: async (ctx) => {return bool} // If bool false, query callback not run
-      // after : async (ctx, result) => {return modified_result}
-      
-      crud: [{
-        prefix: '',
-        routes: [/*
+      //         it can also be an array of functions
+      // after : async (ctx, data) => {return modified_data}
+      //         it can also be an array of functions
+
+      crud: [
+        {
+          prefix: "",
+          routes: [
+            /*
           name: '',
           url: '/../..', // default to 'name'
           mode: 'r/w/rw',
@@ -170,9 +195,12 @@ export default function make_config_defaults() {
           auth: ...,
           before: ...,
           after : ...
-        */], 
-      }],
-      queries: [/*
+        */
+          ]
+        }
+      ],
+      queries: [
+        /*
         {
           prefix: '',
           auth: ...,
@@ -183,31 +211,43 @@ export default function make_config_defaults() {
             {
               url: '/../..',
               method: 'GET/POST',
-              callback: async (ctx) => { ctx.body = result } ,  
-              // or
-              callback_fn: async (miolo, params) => { return result } ,  
+              callback: async (ctx, params) => { 
+                return {ok: true/false, data|error} 
+                // or:
+                //  return <anything>
+                //  and milo will wrap into {ok: true, data: <anything>}
+                // or by yourself:
+                // ctx.body = {ok: true/false, data|error}
+                //  (you may want {keep_body: true})
+              } ,  
               auth: ...,
-              before: ...,
-              after : ...
+              before:  async (ctx) => { return true/false } or array of functions,
+              after :  async (ctx, data) => { return data } or array of functions,
+              schema: {
+                input: a Joi schema for validating input data,
+                output: a Joi schema for validating output data,
+              }
+              keep_body: false by default. If true, miolo wont ensure ctx.body after callback.
             },          
           ], 
         },
-      */],
+      */
+      ]
     },
     log: {
-      level: process.env.MIOLO_LOG_LEVEL || 'debug',
+      level: process.env.MIOLO_LOG_LEVEL || "debug",
       format: {
-        locale: 'en-GB'
+        locale: "en-GB"
       },
       console: {
-        enabled: process.env.MIOLO_LOG_CONSOLE_ENABLED === 'true',
-        level: process.env.MIOLO_LOG_CONSOLE_LEVEL || process.env.MIOLO_LOG_LEVEL || 'debug',
+        enabled: process.env.MIOLO_LOG_CONSOLE_ENABLED === "true",
+        level: process.env.MIOLO_LOG_CONSOLE_LEVEL || process.env.MIOLO_LOG_LEVEL || "debug"
       },
       file: {
-        enabled: process.env.MIOLO_LOG_FILE_ENABLED === 'true',
-        level: process.env.MIOLO_LOG_FILE_LEVEL || process.env.MIOLO_LOG_LEVEL || 'debug',
-        filename: process.env.MIOLO_LOG_FILE_PATH || '/var/log/afialapis/%MIOLO%.log',
-        
+        enabled: process.env.MIOLO_LOG_FILE_ENABLED === "true",
+        level: process.env.MIOLO_LOG_FILE_LEVEL || process.env.MIOLO_LOG_LEVEL || "debug",
+        filename: process.env.MIOLO_LOG_FILE_PATH || "/var/log/afialapis/%MIOLO%.log",
+
         //frequency: undefined,
         //datePattern: 'YYYY-MM-DD',
         zippedArchive: true,
@@ -226,45 +266,45 @@ export default function make_config_defaults() {
         hup_patch: false
       },
       mail: {
-        enabled: process.env.MIOLO_LOG_MAIL_ENABLED 
-        ? process.env.MIOLO_LOG_MAIL_ENABLED === 'true' 
-        : false,
-        level: process.env.MIOLO_LOG_MAIL_LEVEL || process.env.MIOLO_LOG_LEVEL || 'warn',
-        name: process.env.MIOLO_NAME || 'miolo',
-        from: process.env.MIOLO_LOG_MAIL_FROM || 'noreply@mail.com',
-        to: process.env.MIOLO_LOG_MAIL_TO || 'noreply@mail.com'      
+        enabled: process.env.MIOLO_LOG_MAIL_ENABLED
+          ? process.env.MIOLO_LOG_MAIL_ENABLED === "true"
+          : false,
+        level: process.env.MIOLO_LOG_MAIL_LEVEL || process.env.MIOLO_LOG_LEVEL || "warn",
+        name: process.env.MIOLO_NAME || "miolo",
+        from: process.env.MIOLO_LOG_MAIL_FROM || "noreply@mail.com",
+        to: process.env.MIOLO_LOG_MAIL_TO || "noreply@mail.com"
       }
     },
     mail: {
-      silent: process.env.MIOLO_MAILER_SILENT === 'true',
+      silent: process.env.MIOLO_MAILER_SILENT === "true",
       options: {
         //
         // General options
         //
         // port – is the port to connect to (defaults to 587 is secure is false or 465 if true)
-        port: parseInt(process.env.MIOLO_MAILER_PORT || 25),
+        port: parseInt(process.env.MIOLO_MAILER_PORT || 25, 10),
         // host – is the hostname or IP address to connect to (defaults to ‘localhost’)
-        host: process.env.MIOLO_MAILER_HOST || 'mail.com',
-        // auth – defines authentication data 
-        //        If authentication data is not present, the connection is considered authenticated from the start. 
+        host: process.env.MIOLO_MAILER_HOST || "mail.com",
+        // auth – defines authentication data
+        //        If authentication data is not present, the connection is considered authenticated from the start.
         //        Otherwise you would need to provide the authentication options object.
         //   - type indicates the authetication type, defaults to ‘login’, other option is ‘oauth2’
         //   - user is the username
         //   - pass is the password for the user if normal login is used
         // authMethod – defines preferred authentication method, defaults to ‘PLAIN’
-        authMethod: process.env.MIOLO_MAILER_AUTH_METHOD || 'PLAIN',
-        ... process.env.MIOLO_MAILER_AUTH_METHOD === 'LOGIN'
+        authMethod: process.env.MIOLO_MAILER_AUTH_METHOD || "PLAIN",
+        ...(process.env.MIOLO_MAILER_AUTH_METHOD === "LOGIN"
           ? {
-            auth: {
-              user: process.env.MIOLO_MAILER_SMTP_USER || 'noreply@mail.com',
-              pass: process.env.MIOLO_MAILER_SMTP_PASS || '****',
-              type: 'login',
-            },
-            secure: true,
-          }
+              auth: {
+                user: process.env.MIOLO_MAILER_SMTP_USER || "noreply@mail.com",
+                pass: process.env.MIOLO_MAILER_SMTP_PASS || "****",
+                type: "login"
+              },
+              secure: true
+            }
           : {
-            secure: false
-          },
+              secure: false
+            }),
 
         //
         // TLS options
@@ -272,18 +312,17 @@ export default function make_config_defaults() {
         // secure – if true the connection will use TLS when connecting to server.
         //          If false (the default) then TLS is used if server supports the STARTTLS extension.
         //          In most cases set this value to true if you are connecting to port 465. For port 587 or 25 keep it false
-        //    ** Setting secure to false does not mean that you would not use an encrypted connection. Most SMTP servers allow 
+        //    ** Setting secure to false does not mean that you would not use an encrypted connection. Most SMTP servers allow
         //       connection upgrade via STARTTLS command but to use this you have to connect using plaintext first
-      
-        
+
         // tls – defines additional node.js TLSSocket options to be passed to the socket constructor, eg. {rejectUnauthorized: true}.
         tls: {
-            // do not fail on invalid certs
-            rejectUnauthorized: false
-        } ,
+          // do not fail on invalid certs
+          rejectUnauthorized: false
+        },
         // ignoreTLS – if this is true and secure is false then TLS is not used even if the server supports STARTTLS extension
         // ** ignoreTLS: false,
-        // requireTLS – if this is true and secure is false then Nodemailer tries to use STARTTLS even 
+        // requireTLS – if this is true and secure is false then Nodemailer tries to use STARTTLS even
         //              if the server does not advertise support for it. If the connection can not be encrypted then message is not sent
         // ** requireTLS: true,
         //
@@ -302,15 +341,15 @@ export default function make_config_defaults() {
         //
         // Debug options
         //
-        // logger – optional bunyan compatible logger instance. If set to true then logs to console. 
+        // logger – optional bunyan compatible logger instance. If set to true then logs to console.
         //          If value is not set or is false then nothing is logged
         logger: false,
         // debug – if set to true, then logs SMTP traffic, otherwise logs only transaction events
-        debug: false,
+        debug: false
         //
         // Security options
         //
-        // disableFileAccess – if true, then does not allow to use files as content. 
+        // disableFileAccess – if true, then does not allow to use files as content.
         //                     Use it when you want to use JSON data from untrusted source as the email.
         //                    If an attachment or message node tries to fetch something from a file the sending returns an error
         ////disableFileAccess: ,
@@ -328,9 +367,9 @@ export default function make_config_defaults() {
         //         Read about proxy support in Nodemailer from here: https://nodemailer.com/smtp/proxies/
       },
       defaults: {
-        name: process.env.MIOLO_NAME || 'miolo',
-        from: process.env.MIOLO_MAILER_FROM || 'noreply@mail.com',
-        to: process.env.MIOLO_MAILER_TO || 'noreply@mail.com'
+        name: process.env.MIOLO_NAME || "miolo",
+        from: process.env.MIOLO_MAILER_FROM || "noreply@mail.com",
+        to: process.env.MIOLO_MAILER_TO || "noreply@mail.com"
       }
     },
     auth: {
@@ -339,29 +378,32 @@ export default function make_config_defaults() {
       //  realm: '',
       //  paths: [],
       //},
-      //credentials: {
-      //  get_user_id:  (user, done, miolo) => done(null, user.id), // default
-      //  find_user_by_id: (id, done, miolo) => done(null, {id: 1}),  // ok=> done(null, user)  err=> done(error, null)
-      //  local_auth_user: (username, password, done, miolo) => done(null, {id: 1})
-      //                   // auth=> done(null, user) noauth=> done(null, false, {message: ''}) err=> done(error, null)
-      //  url_login : '/login',
-      //  url_logout: '/logout',
-      //  url_login_redirect: undefined
-      //  url_logout_redirect: '/'
-      //}
       //guest: {
       //  make_guest_token: undefined // (session) => ''
       //},
-      //custom: callback,
-      //  here callback receives (app)
-      //  and returns:
-      //    - a middleware function
-      //    or
-      //    - an array like [{
-      //        method: 'GET' // POST,...
-      //        url:    '/aa/bb',
-      //        callback: a middleware function
-      //      }, ...]
+      //passport: {
+      //  get_user_id:  (user, done, ctx) => done(null, user.id), // default
+      //  find_user_by_id: (id, done, ctx) => done(null, {id: 1}),  // ok=> done(null, user)  err=> done(error, null)
+      //  local_auth_user: (username, password, done, ctx) => done(null, {id: 1})
+      //                   auth  => done(null, user)
+      //                   noauth=> done(null, false, {message: ''})
+      //                   err   => done(error, null)
+      //  local_url_login : '/login',
+      //  local_url_logout: '/logout',
+      //  local_url_login_redirect: '/
+      //  local_url_logout_redirect: '/'
+      //  google_auth_user: (accessToken, refreshToken, profile, done, ctx) => done(null, {id: 1})
+      //                   auth  => done(null, user)
+      //                   noauth=> done(null, false, {message: ''})
+      //                   err   => done(error, null)
+      //  google_client_id: 'your-google-client-id',
+      //  google_client_secret: 'your-google-client-secret',
+      //  google_url_login : '/auth/google',
+      //  google_url_callback : '/auth/google/callback',
+      //  google_url_logout: '/logout',
+      //  google_url_login_redirect: undefined
+      //  google_url_logout_redirect: '/'
+      //}
     },
 
     middlewares: [
@@ -371,7 +413,7 @@ export default function make_config_defaults() {
     cron: [
       // {
       //   name,
-      //   cronTime, 
+      //   cronTime,
       //   onTick: async (miolo, onComplete),
       //      Notice that if task runs too fast, you may see that
       //       onTick is actually never run, but onComplete is.
@@ -388,44 +430,59 @@ export default function make_config_defaults() {
       // Default options passed to cacheiro for
       // every other cache
       default: {
-        type: 'combined',
+        type: process.env.MIOLO_CACHE_TYPE || "combined",
         redis: {
-          host: '127.0.0.1',
-          port: 6379
+          host:
+            process.env?.IS_DOCKER === "true"
+              ? process.env.MIOLO_REDIS_HOSTNAME_DOCKER || "redis"
+              : process.env.MIOLO_REDIS_HOSTNAME || "127.0.0.1",
+          port: parseInt(process.env.MIOLO_REDIS_PORT || 6379, 10)
         },
-        version: parseInt(process.env.MIOLO_CACHE_VERSION || 1),
-        clean: false,
+        version: parseInt(process.env.MIOLO_CACHE_VERSION || 1, 10),
+        clean: false
       },
-      
+
       // specific cache options for calustra
       calustra: {
-        namespace: 'miolo-calustra',
-        ttl: parseInt(process.env.MIOLO_CACHE_CALUSTRA_TTL || 86400*1000),
-        version: parseInt(process.env.MIOLO_CACHE_CALUSTRA_VERSION || process.env.MIOLO_CACHE_VERSION || 1)
+        namespace: "miolo-calustra",
+        ttl: parseInt(process.env.MIOLO_CACHE_CALUSTRA_TTL || 86400 * 1000, 10),
+        version: parseInt(
+          process.env.MIOLO_CACHE_CALUSTRA_VERSION || process.env.MIOLO_CACHE_VERSION || 1,
+          10
+        )
       },
 
       // specific cache options for koa-session
       session: {
-        namespace: 'miolo-session',
-        ttl: parseInt(process.env.MIOLO_CACHE_SESSION_TTL || process.env.MIOLO_SESSION_MAX_AGE || SESSION_MAX_AGE),
-        version: parseInt(process.env.MIOLO_CACHE_SESSION_VERSION || process.env.MIOLO_CACHE_VERSION || 1)
+        namespace: "miolo-session",
+        ttl: parseInt(
+          process.env.MIOLO_CACHE_SESSION_TTL ||
+            process.env.MIOLO_SESSION_MAX_AGE ||
+            SESSION_MAX_AGE,
+          10
+        ),
+        version: parseInt(
+          process.env.MIOLO_CACHE_SESSION_VERSION || process.env.MIOLO_CACHE_VERSION || 1,
+          10
+        )
       },
-      
+
       // custom cache instances
       // will be inited by miolo, and available through ctx.miolo.cache.get_cache('name')
       custom: {
-      // <name>: {options}
+        // <name>: {options}
       }
-
-
     },
 
     socket: {
       enabled: false,
+      // Auto create rooms based on sessions
+      // To be able to do like: app.context.miolo.io.to('user_<id>').emit('ns', newData);
+      userRooms: true,
       cli: {
         /**
-         domain: '',
-        options: {}
+         url: '',
+         options: {}
         */
       }
       /*
@@ -439,39 +496,50 @@ export default function make_config_defaults() {
     },
 
     build: {
-      
-      client: process.env.NODE_ENV === 'production'
-        ? `${process.env.MIOLO_BUILD_CLIENT_DEST || './dist/cli'}/${process.env.MIOLO_NAME || 'miolo'}.${process.env.MIOLO_BUILD_CLIENT_SUFFIX || 'iife.bundle.min'}.js`
-        : process.env.MIOLO_BUILD_CLIENT_ENTRY,
-      
-      html: process.env.MIOLO_BUILD_HTML_FILE || './src/cli/index.html',
+      client:
+        process.env.NODE_ENV === "production"
+          ? `${process.env.MIOLO_BUILD_CLIENT_DEST || "./build/cli"}/${process.env.MIOLO_NAME || "miolo"}.${process.env.MIOLO_BUILD_CLIENT_SUFFIX || "iife.bundle.min"}.js`
+          : process.env.MIOLO_BUILD_CLIENT_ENTRY,
+
+      html:
+        process.env.MIOLO_BUILD_HTML_FILE === "false"
+          ? ""
+          : process.env.MIOLO_BUILD_HTML_FILE || "./src/cli/index.html",
 
       vite: {
-        base: '/',
-        root: '',
+        base: "/",
+        root: "",
         watch: {
           // During tests we edit the files too fast and sometimes chokidar
           // misses change events, so enforce polling for consistency
           usePolling: true,
-          interval: 100,
-        }, 
+          interval: 100
+        },
+        ssr: {
+          noExternal: ["miolo-react"]
+        }
       },
-        
+
       ssr: {
-        server: process.env.NODE_ENV === 'production'
-        ? path.join(process.cwd(), `${process.env.MIOLO_BUILD_SERVER_DEST || './dist/server'}/entry-server.js`)
-        : process.env.MIOLO_BUILD_SERVER_SSR_ENTRY || './src/server/ssr/entry-server.jsx',
+        server:
+          process.env.NODE_ENV === "production"
+            ? path.join(
+                process.cwd(),
+                `${process.env.MIOLO_BUILD_SERVER_DEST || "./build/server"}/entry-server.js`
+              )
+            : process.env.MIOLO_BUILD_SERVER_SSR_ENTRY || "./src/server/ssr/entry-server.jsx"
         // loader: async (ctx) => {}
       },
 
       dev: {
         watcher: {
-          enabled: process.env.MIOLO_DEV_WATCH_ENABLED==='true',
-          dirs: process.env.MIOLO_DEV_WATCH_DIRS?.split(',')?.map(dir => path.join(process.cwd(), dir)) || [],
-        },
+          enabled: process.env.MIOLO_DEV_WATCH_ENABLED === "true",
+          dirs:
+            process.env.MIOLO_DEV_WATCH_DIRS?.split(",")?.map((dir) =>
+              path.join(process.cwd(), dir)
+            ) || []
+        }
       }
     }
   }
 }
-
-