@vulkano/core 1.18.1 → 1.19.0

package/app.js

@@ -10,9 +10,9 @@
 global.START_TIME = Date.now();
 
 const dotenv = require('dotenv');
-const path = require('path');
-const v8 = require('v8');
-const fs = require('fs');
+const path = require('node:path');
+const v8 = require('node:v8');
+const fs = require('node:fs');
 
 global.app = {};
 
@@ -149,7 +149,9 @@ async function startVulkano() {
   console.log('');
   console.log(`${colors.fg.cyan}${showCenteredText('🌋')}${colors.reset}`);
   console.log(`${colors.fg.cyan}${showCenteredText(`${appName} ${appVersion}`)}${colors.reset}`);
-  console.log(`${colors.fg.cyan}${showCenteredText(`${pkg.name} ${pkg.version}`.toUpperCase())}${colors.reset}`);
+  console.log(
+    `${colors.fg.cyan}${showCenteredText(`${pkg.name} ${pkg.version}`.toUpperCase())}${colors.reset}`
+  );
   console.log('');
   console.log(`${colors.fg.blue}🔗 github.com/vulkanojs/vulkano${colors.reset}`);
   console.log(`${colors.fg.cyan}☕ buymeacoffee.com/argordmel${colors.reset}`);
@@ -193,9 +195,7 @@ async function startVulkano() {
 
       const nodeVersion = process.version.match(/^v(\d+\.\d+\.\d+)/)[1];
       const portText = String(app.vulkano.get('port') || 8000);
-      const socketText = sockets.enabled
-        ? String(sockets.adapter || 'memory').toUpperCase()
-        : 'NO';
+      const socketText = sockets.enabled ? String(sockets.adapter || 'memory').toUpperCase() : 'NO';
 
       serverConfig.push(`🚀 PORT: ${colors.fg.green}${showColumn(portText, 7)}${colors.reset}`);
       serverConfig.push(' | ');
@@ -238,7 +238,9 @@ async function startVulkano() {
 
       const startupMs = ((Date.now() - global.START_TIME) / 1000).toFixed(3);
       console.log(`${colors.fg.magenta}${cutLine}${colors.reset}`);
-      console.log(`${colors.bright}${colors.fg.cyan}${showCenteredText(`⚡ Ready in ${startupMs}s`)}${colors.reset}`);
+      console.log(
+        `${colors.bright}${colors.fg.cyan}${showCenteredText(`⚡ Ready in ${startupMs}s`)}${colors.reset}`
+      );
       console.log(`${colors.fg.magenta}${cutLine}${colors.reset}`);
 
       if (vite?.enabled) {

package/bin/setup.js

@@ -7,9 +7,9 @@
  * creates the minimal folder structure and config files needed to start.
  */
 
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
+const fs = require('node:fs');
+const path = require('node:path');
+const readline = require('node:readline');
 
 // npm sets INIT_CWD to the directory where `npm install` was invoked.
 // npm_config_local_prefix is the project root (directory containing node_modules).

package/bootstrap/engines/handlebars.js

@@ -0,0 +1,55 @@
+const { create: hbsCreate } = require('express-handlebars');
+
+// Wraps a Nunjucks-style function so it works as a Handlebars helper:
+//   Hash params  → {{{helper key=val}}}  calls fn({ key: val })
+//   Positional   → {{helper value}}      calls fn(value)
+//   String output is wrapped in SafeString to prevent double-escaping
+function wrapHelper(hbs, fn) {
+  return function hbsHelper(...args) {
+    const hbsOpts = args[args.length - 1];
+    const isHbsOptions = hbsOpts && typeof hbsOpts === 'object' && 'hash' in hbsOpts;
+    let result;
+    if (isHbsOptions) {
+      const positional = args.slice(0, -1);
+      result = positional.length === 0 ? fn(hbsOpts.hash) : fn(...positional);
+    } else {
+      result = fn(...args);
+    }
+    return typeof result === 'string' ? new hbs.handlebars.SafeString(result) : result;
+  };
+}
+
+function registerGroup(hbs, groups, method) {
+  (groups || []).forEach((group) => {
+    Object.keys(group || {}).forEach((key) => {
+      hbs.handlebars[method](key, wrapHelper(hbs, group[key]));
+    });
+  });
+}
+
+module.exports = function setupHandlebars(vulkano, views, viewsExt) {
+  const hbs = hbsCreate({
+    extname: viewsExt,
+    defaultLayout: views.defaultLayout !== undefined ? views.defaultLayout : 'default',
+    layoutsDir: views.layoutsDir || `${views.path}/_shared/templates`,
+    partialsDir: views.partialsDir || `${views.path}/_shared/partials`,
+    ...(views.settings || {})
+  });
+
+  registerGroup(hbs, views.filters, 'registerHelper');
+  registerGroup(hbs, views.helpers, 'registerHelper');
+
+  vulkano.use((_req, res, next) => {
+    (views.globals || []).forEach((group) => {
+      Object.assign(res.locals, group || {});
+    });
+    res.locals.app = app;
+    next();
+  });
+
+  vulkano.engine(viewsExt, hbs.engine);
+  vulkano.set('view engine', viewsExt);
+
+  app.server.views._engine = hbs;
+  app.handlebars = hbs;
+};

package/bootstrap/engines/index.js

@@ -0,0 +1,31 @@
+const viewsConfig = require('../views');
+
+const SUPPORTED_ENGINES = ['nunjucks', 'handlebars'];
+
+module.exports = function setupViewEngine(vulkano) {
+  const views = {
+    ext: '.html',
+    ...viewsConfig,
+    ...(app.server.views || {})
+  };
+
+  const engine = views.engine || 'nunjucks';
+  const ext = views.ext || '.html';
+
+  if (!SUPPORTED_ENGINES.includes(engine)) {
+    throw new Error(
+      `Vulkano: unsupported view engine "${engine}". Supported engines: ${SUPPORTED_ENGINES.join(', ')}.`
+    );
+  }
+
+  vulkano.set('views', views.path);
+
+  if (engine === 'handlebars') {
+    require('./handlebars')(vulkano, views, ext);
+  } else {
+    require('./nunjucks')(vulkano, views);
+  }
+
+  // Error view subfolder depends on engine (core dev-mode error templates)
+  return engine;
+};

package/bootstrap/engines/nunjucks.js

@@ -0,0 +1,33 @@
+const nunjucks = require('nunjucks');
+
+module.exports = function setupNunjucks(vulkano, views) {
+  const settings = {
+    autoescape: true,
+    watch: !app.PRODUCTION,
+    ...(views.settings || {}),
+    express: vulkano
+  };
+
+  const env = nunjucks.configure([views.path, CORE_PATH], settings);
+
+  env.addGlobal('app', app);
+
+  (views.globals || []).forEach((group) => {
+    Object.keys(group || {}).forEach((key) => env.addGlobal(key, group[key]));
+  });
+
+  (views.helpers || []).forEach((group) => {
+    Object.keys(group || {}).forEach((key) => env.addGlobal(key, group[key]));
+  });
+
+  (views.filters || []).forEach((group) => {
+    Object.keys(group || {}).forEach((key) => env.addFilter(key, group[key]));
+  });
+
+  (views.extensions || []).forEach((group) => {
+    Object.keys(group || {}).forEach((key) => env.addExtension(key, group[key]));
+  });
+
+  app.server.views._engine = env;
+  app.nunjucks = nunjucks;
+};

package/bootstrap/express.js

@@ -1,4 +1,4 @@
-const path = require('path');
+const path = require('node:path');
 
 const merge = require('../libs/Merge');
 

package/bootstrap/responses.js

@@ -1,4 +1,4 @@
-const path = require('path');
+const path = require('node:path');
 
 // Include all user's responses
 const VulkanoResponses = require('include-all')({