edge-functions 1.0.0 → 1.3.0

package/lib/presets/default/html/deliver/handler.js

@@ -1,9 +1,16 @@
-import { mountSSG } from "#edge";
+import { mountSSG } from '#edge';
 
-try {
-  const myApp = await mountSSG(event.request.url, AZION.VERSION_ID);
-  return myApp;
-} catch (e) {
-  const notFoundError = new URL(`${AZION.VERSION_ID}/404.html`, 'file://')
-  return fetch(notFoundError)
+/**
+ * Handles the 'fetch' event.
+ * @param {FetchEvent} event - The fetch event.
+ * @returns {Promise<Response>} The response for the request.
+ */
+async function handle(event) {
+  try {
+    const myApp = await mountSSG(event.request.url, AZION_VERSION_ID);
+    return myApp;
+  } catch (e) {
+    const notFoundError = new URL(`${AZION_VERSION_ID}/404.html`, 'file://');
+    return fetch(notFoundError);
+  }
 }

package/lib/presets/default/html/deliver/prebuild.js

@@ -4,10 +4,11 @@ import { copyDirectory } from '#utils';
 
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
+async function prebuild(buildContext) {
   const sourceDir = process.cwd();
-  const targetDir = join('.', '.edge', 'statics');
+  const targetDir = join('.', '.edge', 'storage');
 
   copyDirectory(sourceDir, targetDir);
 }

package/lib/presets/default/javascript/compute/config.js

@@ -2,12 +2,9 @@
  * Config to be used in build context.
  */
 const config = {
-  builder: 'webpack',
+  builder: 'esbuild',
   useNodePolyfills: false,
-  custom: {
-    config: {},
-    plugins: [],
-  },
+  custom: {},
 };
 
 export default config;

package/lib/presets/default/javascript/compute/handler.js

@@ -1,5 +1,16 @@
-try {
-  __JS_CODE__;
-} catch (e) {
-  return new Response(e.message || e.toString(), { status: 500 });
+/* eslint-disable */
+__JS_CODE__
+
+/**
+ * Handles the 'fetch' event.
+ * @param {FetchEvent} event - The fetch event.
+ * @returns {Promise<Response>} The response for the request.
+ */
+async function handle(event) {
+  try {
+    return main(event);
+  } catch (e) {
+    return new Response(e.message || e.toString(), { status: 500 });
+  }
 }
+/* eslint-enable */

package/lib/presets/default/javascript/compute/prebuild.js

@@ -1,6 +1,7 @@
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-function prebuild() {}
+async function prebuild(buildContext) { }
 
 export default prebuild;

package/lib/presets/default/typescript/compute/config.js

@@ -0,0 +1,10 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'esbuild',
+  useNodePolyfills: false,
+  custom: {},
+};
+
+export default config;

package/lib/presets/default/typescript/compute/handler.js

@@ -0,0 +1,16 @@
+/* eslint-disable */
+__JS_CODE__
+
+/**
+ * Handles the 'fetch' event.
+ * @param {FetchEvent} event - The fetch event.
+ * @returns {Promise<Response>} The response for the request.
+ */
+async function handle(event) {
+  try {
+    return main(event);
+  } catch (e) {
+    return new Response(e.message || e.toString(), { status: 500 });
+  }
+}
+/* eslint-enable */

package/lib/presets/default/typescript/compute/prebuild.js

@@ -0,0 +1,7 @@
+/**
+ * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
+ */
+async function prebuild(buildContext) { }
+
+export default prebuild;

package/lib/providers/azion/worker.js

@@ -1,12 +1,16 @@
+/* eslint-disable */
+__HANDLER__
+
 /**
  * Handles the 'fetch' event.
  * @param {FetchEvent} event - The fetch event.
  * @returns {Promise<Response>} The response for the request.
  */
 async function handleEvent(event) {
-  __HANDLER__
+  return handle(event);
 }
 
 addEventListener('fetch', (event) => {
   event.respondWith(handleEvent(event));
-});
+});
+/* eslint-enable */

package/lib/utils/exec/exec.utils.js

@@ -9,50 +9,61 @@ import signale from 'signale';
  * @param {string} command - The command to be executed.
  * @param {string} [scope='Process'] - Log scope. The default is 'Process'.
  * @param {boolean} [verbose=false] - Whether to display the output in real-time.
+ * @param {boolean} [interactive=false] - Whether to allow user
+ * interaction with the running process.
  * @returns {Promise<void>} A promise that resolves when the command completes successfully.
+ * @throws Will throw an error if the command exits with a non-zero status code.
  * @example
  * // Executing a command without verbose output
  * await exec('npm install');
  *
  * // Executing a command with verbose output
  * await exec('npm run build', 'Build', true);
+ *
+ * // Executing an interactive command
+ * await exec('npx vue create my-project', 'Vue', false, true);
  */
-async function exec(command, scope = 'Process', verbose = false) {
+async function exec(command, scope = 'Process', verbose = false, interactive = false) {
   const stream = new signale.Signale({ interactive: true, scope: ['Process', scope] });
 
   return new Promise((resolve, reject) => {
     const args = command.split(' ');
     const cmd = args.shift();
 
-    const buildProcess = spawn(cmd, args, { shell: true });
+    const execProcess = spawn(cmd, args, {
+      shell: true,
+      stdio: interactive ? 'inherit' : 'pipe',
+    });
+
+    if (!interactive) {
+      if (verbose) {
+        execProcess.stdout.on('data', (data) => {
+          stream.info(data.toString());
+        });
 
-    if (verbose) {
-      buildProcess.stdout.on('data', (data) => {
-        stream.info(data.toString());
+        execProcess.stderr.on('data', (data) => {
+          const dataStr = data.toString();
+          if (dataStr.toLowerCase().includes('error')) {
+            stream.error(dataStr);
+          } else {
+            stream.info(dataStr);
+          }
+        });
+      }
+
+      execProcess.on('error', (error) => {
+        reject(error);
       });
 
-      buildProcess.stderr.on('data', (data) => {
-        // Some tools and libraries choose to use stderr for process logging or informational messages.
-        const dataStr = data.toString();
-        if (dataStr.toLowerCase().includes('error')) {
-          stream.error(dataStr);
+      execProcess.on('close', (code) => {
+        if (code === 0) {
+          resolve();
         } else {
-          stream.info(dataStr);
+          reject(new Error(`Command '${command}' failed with code ${code}`));
         }
       });
     }
-
-    buildProcess.on('error', (error) => {
-      reject(error);
-    });
-
-    buildProcess.on('close', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Command '${command}' failed with code ${code}`));
-      }
-    });
   });
 }
+
 export default exec;

package/lib/utils/feedback/feedback.utils.js

@@ -57,10 +57,14 @@ if (cleanOutputEnabled) {
  */
 const scopes = {
   ...global,
+  interactive: { ...getLogger({ interactive: true, scope: ['Vulcan'], types: methods }) },
+  server: { ...global.scope('Vulcan', 'Server'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Server'], types: methods }) },
+  runtime: { ...global.scope('Vulcan', 'Runtime'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Runtime'], types: methods }) },
   prebuild: { ...global.scope('Vulcan', 'Pre Build'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Pre Build'], types: methods }) },
   build: { ...global.scope('Vulcan', 'Build'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Build'], types: methods }) },
-  platform: { ...global.scope('Vulcan', 'Platform'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Plataform'], types: methods }) },
-  statics: { ...global.scope('Vulcan', 'Statics'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Statics'], types: methods }) },
+  platform: { ...global.scope('Vulcan', 'Platform'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Platform'], types: methods }) },
+  statics: { ...global.scope('Vulcan', 'Storage'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'storage'], types: methods }) },
+  logs: (scope1, scope2, scope3) => ({ ...global.scope('Azion', `${scope1}`, scope2, scope3) }),
   propagation: { ...global.scope('Azion', 'Edge Network'), interactive: getLogger({ interactive: true, scope: ['Vulcan', 'Azion Network'], types: methods }) },
 };
 /**

package/lib/utils/getAbsoluteLibDirPath/getAbsoluteLibDirPath.utils.js

@@ -1,3 +1,4 @@
+const isWindows = process.platform === 'win32';
 /**
  * Get the absolute path of the lib directory based on the current module.
  * @function
@@ -8,12 +9,20 @@
  *
  * // Example usage:
  * const libDirPath = getAbsoluteLibDirPath();
- * console.log(libDirPath); // "lib/full/path/to/directory"
+ * console.log(libDirPath); // 'lib/full/path/to/directory'
  */
 function getAbsoluteLibDirPath() {
   const currentModuleFullPath = import.meta.url;
   let baselibPath = currentModuleFullPath.match(/(.*lib)(.*)/)[1];
-  baselibPath = baselibPath.replace('file://', '');
+  if (isWindows) {
+    baselibPath = new URL(baselibPath).pathname;
+    if (baselibPath.startsWith('/')) {
+      baselibPath = baselibPath.slice(1);
+    }
+  }
+  if (!isWindows) {
+    baselibPath = baselibPath.replace('file://', '');
+  }
 
   return baselibPath;
 }

package/lib/utils/getVulcanBuildId/getVulcanBuildId.utils.js

@@ -2,7 +2,7 @@ import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
 /**
- * @namespace Utils
+ * @memberof utils
  * @function
  * @name getVulcanBuildId
  * @description Fetches the unique build ID for the current project from the

package/lib/utils/index.js

@@ -6,11 +6,12 @@ import generateTimestamp from './generateTimestamp/index.js';
 import getAbsoluteLibDirPath from './getAbsoluteLibDirPath/index.js';
 import getVulcanBuildId from './getVulcanBuildId/index.js';
 import getPackageManager from './getPackageManager/index.js';
-import getPresetsList from './getPresetsList/index.js';
+import presets from './presets/index.js';
 import readWorkerFile from './readWorkerFile/index.js';
 import overrideStaticOutputPath from './overrideStaticOutputPath/index.js';
 import getProjectJsonFile from './getProjectJsonFile/index.js';
 import getPackageVersion from './getPackageVersion/index.js';
+import Spinner from './spinner/index.js';
 
 export {
   copyDirectory,
@@ -23,7 +24,8 @@ export {
   getPackageVersion,
   getProjectJsonFile,
   getVulcanBuildId,
-  getPresetsList,
+  presets,
   overrideStaticOutputPath,
   readWorkerFile,
+  Spinner,
 };

package/lib/utils/overrideStaticOutputPath/overrideStaticOutputPath.utils.js

@@ -12,13 +12,13 @@ import { readFileSync, writeFileSync } from 'fs';
  * The regex pattern should include a capturing group (i.e., (.*) )
  * to identify the value to be replaced.
  * For example, /out:(.*)\n/.
- * @param {string} [newOutputPath='.edge/statics'] - The default is '.edge/statics'.
+ * @param {string} [newOutputPath='.edge/storage'] - The default is '.edge/storage'.
  * @throws Will throw an error if the function fails to override the output path.
  * @example
  *
  * overrideStaticOutputPath('./config.js', /out:(.*)\n/);
  */
-function overrideStaticOutputPath(configFilePath, regexPattern, newOutputPath = '.edge/statics') {
+function overrideStaticOutputPath(configFilePath, regexPattern, newOutputPath = '.edge/storage') {
   try {
     const fileContent = readFileSync(configFilePath, 'utf-8');
 

package/lib/utils/presets/index.js

@@ -0,0 +1,3 @@
+import presets from './presets.utils.js';
+
+export default presets;

package/lib/utils/presets/presets.utils.js

@@ -0,0 +1,169 @@
+import fs from 'fs';
+import path from 'path';
+
+const isWindows = process.platform === 'win32';
+const currentModuleFullPath = import.meta.url;
+let baselibPath = currentModuleFullPath.match(/(.*lib)(.*)/)[1];
+
+if (isWindows) {
+  baselibPath = new URL(baselibPath).pathname;
+  if (baselibPath.startsWith('/')) {
+    baselibPath = baselibPath.slice(1);
+  }
+}
+if (!isWindows) {
+  baselibPath = baselibPath.replace('file://', '');
+}
+
+/**
+ * Retrieves a list of presets from 'default' and 'custom' directories in a beautified format.
+ * Unlike `getKeys`, this method returns preset names formatted
+ * for display and includes modes like '(Static)' or '(Server)'.
+ * @function
+ * @memberof presets
+ * @name getBeautify
+ * @param {string[]} [types=['default', 'custom']] - The types of presets to list.
+ * Each type corresponds to a folder in the 'presets' directory.
+ * @returns {string[]} The list of presets with modes like '(Static)' or '(Server)' if applicable.
+ * @example
+ * const presetsList = getBeautify(['default', 'custom']);
+ * console.log(presetsList);
+ * // Output might be: ['Angular (Static)', 'React (Server)', 'Vue (Static)']
+ */
+function getBeautify(types = ['default', 'custom']) {
+  const presets = [];
+
+  types.forEach((type) => {
+    const presetsDir = path.join(baselibPath, `presets/${type}`);
+    const folders = fs
+      .readdirSync(presetsDir, { withFileTypes: true })
+
+      .filter((dirent) => dirent.isDirectory())
+      .flatMap((dirent) => {
+        const presetName = dirent.name;
+        const subDirs = fs
+          .readdirSync(path.join(presetsDir, presetName), {
+            withFileTypes: true,
+          })
+          .filter((subDirent) => subDirent.isDirectory());
+
+        if (subDirs.length === 0) {
+          return [presetName.charAt(0).toUpperCase() + presetName.slice(1)];
+        }
+
+        return subDirs.map((subDir) => {
+          const subDirName = subDir.name.charAt(0).toUpperCase() + subDir.name.slice(1);
+          return `${
+            presetName.charAt(0).toUpperCase() + presetName.slice(1)
+          } (${subDirName})`;
+        });
+      });
+
+    presets.push(...folders);
+  });
+
+  return presets;
+}
+
+/**
+ * Retrieves an array of valid preset keys by scanning through
+ * the preset directories 'default' and 'custom'.
+ * Each folder name in these directories is considered as a valid preset key.
+ * Unlike `getBeautify`, this method returns raw preset names without any formatting or modes.
+ * @function
+ * @memberof presets
+ * @name getKeys
+ * @returns {string[]} An array of valid build presets.
+ * @example
+ * const validPresetsKeys = getKeys();
+ * console.log(validKeys);
+ * // Output might be: ['angular', 'react', 'vue']
+ * @throws {Error} Throws an error if unable to read the directory.
+ */
+function getKeys() {
+  const types = ['default', 'custom'];
+  const validPresets = [];
+
+  types.forEach((type) => {
+    const presetsPath = path.join(baselibPath, 'presets', type);
+    const directories = fs
+      .readdirSync(presetsPath, { withFileTypes: true })
+      .filter((dirent) => dirent.isDirectory())
+      .map((dirent) => dirent.name);
+
+    validPresets.push(...directories);
+  });
+
+  return validPresets;
+}
+
+/**
+ * Creates a new preset in the lib/presets/custom/${mode} directory.
+ * Also generates three required files: handler.js, prebuild.js, and config.js.
+ * @function
+ * @memberof utils
+ * @name set
+ * @param {string} name - The name of the new preset.
+ * @param {'compute'|'deliver'} mode - The mode for the preset, either 'compute' or 'deliver'.
+ * @throws {Error} Throws an error if a preset with the same name
+ * already exists or if mode is invalid.
+ * @example
+ *
+ * // Create a new preset named 'MyPreset' in 'compute' mode
+ * presets.set('MyPreset', 'compute');
+ */
+function set(name, mode) {
+  const presetPath = path.join(baselibPath, 'presets', 'custom', name, mode);
+  fs.mkdirSync(presetPath, { recursive: true });
+
+  if (mode === 'compute') {
+    const defaultFilesPath = path.join(
+      baselibPath,
+      'presets',
+      'default',
+      'javascript',
+      'compute',
+    );
+    const filesToCopy = ['handler.js', 'config.js', 'prebuild.js'];
+
+    filesToCopy.forEach((file) => {
+      const srcPath = path.join(defaultFilesPath, file);
+      const destPath = path.join(presetPath, file);
+      fs.copyFileSync(srcPath, destPath);
+    });
+  }
+  if (mode === 'deliver') {
+    // TODO: Create template for 'deliver' mode init
+    fs.writeFileSync(path.join(presetPath, 'handler.js'), '');
+    fs.writeFileSync(path.join(presetPath, 'prebuild.js'), '');
+    fs.writeFileSync(path.join(presetPath, 'config.js'), '');
+  }
+}
+
+/**
+ * Presets object containing utility functions for working with build presets.
+ * @memberof utils
+ * @property {Function} getKeys - Function to retrieve an array of valid preset keys.
+ * These keys are raw and do not include any modes or formatting.
+ * @property {Function} getBeautify - Function to retrieve a list of presets in a beautified format.
+ * Unlike `getKeys`, the names are formatted and include modes like '(Static)' or '(Server)'.
+ * @property {Function} set - Function to create a new preset along with its required files.
+ * @example
+ * import { presets } from '#utils';
+ *
+ * // Get raw preset keys
+ * const rawKeys = presets.getKeys();
+ *
+ * // Get beautified preset names
+ * const beautifiedNames = presets.getBeautify();
+ *
+ * // Create a new preset
+ * presets.set('MyNewPreset', 'compute');
+ */
+const presets = {
+  getKeys,
+  getBeautify,
+  set,
+};
+
+export default presets;

package/lib/utils/spinner/index.js

@@ -0,0 +1,3 @@
+import Spinner from './spinner.utils.js';
+
+export default Spinner;

package/lib/utils/spinner/spinner.utils.js

@@ -0,0 +1,32 @@
+import signale from 'signale';
+
+class Spinner {
+  constructor(action) {
+    this.action = action;
+    this.frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    this.intervalId = null;
+    this.currentFrameIndex = 0;
+  }
+
+  start() {
+    signale.pending(`Starting ${this.action}...`);
+
+    this.intervalId = setInterval(() => {
+      const frame = this.frames[this.currentFrameIndex];
+      process.stdout.write(`\r${frame} Running ${this.action} ...`);
+      this.currentFrameIndex = (this.currentFrameIndex + 1) % this.frames.length;
+    }, 100);
+  }
+
+  stop() {
+    clearInterval(this.intervalId);
+    signale.success(`${this.action} complete!`);
+  }
+
+  fail() {
+    clearInterval(this.intervalId);
+    signale.error(`${this.action} error`);
+  }
+}
+
+export default Spinner;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "edge-functions",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "Tool to launch and build JavaScript/Frameworks. This tool automates polyfills for Edge Computing and assists in creating Workers, notably for the Azion platform.",
   "main": "lib/main.js",
   "bin": {
@@ -34,16 +34,29 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@angular/cli": "^16.2.0",
+    "@edge-runtime/node-utils": "^2.1.1",
+    "@edge-runtime/primitives": "^3.0.4",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^10.0.1",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^10.0.4",
     "@semantic-release/release-notes-generator": "^11.0.4",
+    "@vue/cli": "^5.0.8",
     "bottleneck": "^2.19.5",
     "chokidar": "^3.5.3",
     "commander": "^10.0.1",
     "conventional-changelog-conventionalcommits": "^6.1.0",
+    "create-astro": "^3.2.2",
+    "create-next-app": "^13.4.19",
+    "create-react-app": "^5.0.1",
+    "create-vue": "^3.7.3",
+    "deepmerge": "^4.3.1",
+    "edge-runtime": "^2.4.5",
+    "esbuild": "^0.18.11",
+    "escape-string-regexp": "^5.0.0",
     "form-data": "^4.0.0",
+    "hexo": "^7.0.0-rc2",
     "inquirer": "^9.2.7",
     "install": "^0.13.0",
     "lodash": "^4.17.21",
@@ -51,8 +64,8 @@
     "mime-types": "^2.1.35",
     "node-polyfill-webpack-plugin": "^2.0.1",
     "npm": "^9.8.0",
-    "open": "^9.1.0",
     "pkg-dir": "^7.0.0",
+    "rollup-plugin-node-polyfills": "^0.2.1",
     "semantic-release": "^21.0.7",
     "semver": "^7.5.2",
     "signale": "^1.4.0",
@@ -79,7 +92,7 @@
     "#root/*": "./",
     "#lib/*": "./lib",
     "#utils": "./lib/utils/index.js",
-    "#polyfills": "./lib/build/polyfills/index.js",
+    "#polyfills": "./lib/env/polyfills/index.js",
     "#build": "./lib/build/dispatcher/index.js",
     "#bundlers": "./lib/build/bundlers/index.js",
     "#notations/*": "./lib/notations",
@@ -96,4 +109,4 @@
     "url": "https://github.com/aziontech/vulcan/issues"
   },
   "homepage": "https://github.com/aziontech/vulcan#readme"
-}
+}