edge-functions 1.0.0 → 1.3.0

package/lib/platform/edgehooks/index.js

@@ -1,5 +1,8 @@
+import debugRequest from './debugRequest/debugRequest.hooks.js';
 import mountSPA from './mountSPA/mountSPA.hooks.js';
 import mountSSG from './mountSSG/mountSSG.hooks.js';
 import ErrorHTML from './ErrorHTML/ErrorHTML.hooks.js';
 
-export { mountSPA, mountSSG, ErrorHTML };
+export {
+  debugRequest, mountSPA, mountSSG, ErrorHTML,
+};

package/lib/polyfills/FetchEvent.polyfills.js

@@ -0,0 +1,13 @@
+import primitives from '@edge-runtime/primitives';
+import { feedback } from '#utils';
+
+class FetchEventPolyfill extends primitives.FetchEvent {
+  constructor(request) {
+    super(request);
+    this.console = {
+      log: (log) => feedback.server.log(log),
+    };
+  }
+}
+
+export default FetchEventPolyfill;

package/lib/polyfills/fetch.polyfills.js

@@ -0,0 +1,39 @@
+import { join } from 'path';
+import { readFileSync } from 'fs';
+import mime from 'mime-types';
+import { EdgeRuntime } from 'edge-runtime';
+
+/**
+ * A custom fetch implementation that adds an additional path to the URL if it starts with 'file://'.
+ * This function is used to simulate the local edge environment. When a 'file://' request is made,
+ * it behaves as if the request is made from within the edge itself. In this case, an additional
+ * '.edge/storage' folder is appended to the URL to represent the edge environment.
+ * @param {EdgeRuntime} context - VMContext
+ * @param {URL} url - The URL to fetch.
+ * @param {object} [options] - The fetch options.
+ * @returns {Promise<Response>} A Promise that resolves to the Response object.
+ */
+async function fetchPolyfill(context, url, options) {
+  const {
+    URL, Headers, Response,
+  } = context;
+
+  const urlOBJ = new URL(url);
+  if (urlOBJ.href.startsWith('file://')) {
+    // url pathname = /VERSION_ID/filePath
+    const file = url.pathname.slice(15);
+    const filePath = join(process.cwd(), '.edge', 'storage', file);
+    const fileContent = readFileSync(filePath);
+    const contentType = mime.lookup(filePath) || 'application/octet-stream';
+
+    const headers = new Headers();
+    headers.append('Content-Type', contentType);
+
+    const response = new Response(fileContent, { headers, ...options });
+    return response;
+  }
+
+  return fetch(url, options);
+}
+
+export default fetchPolyfill;

package/lib/polyfills/index.js

@@ -0,0 +1,4 @@
+import fetchPolyfill from './fetch.polyfills.js';
+import FetchEventPolyfill from './FetchEvent.polyfills.js';
+
+export { fetchPolyfill, FetchEventPolyfill };

package/lib/presets/custom/angular/deliver/config.js

@@ -3,10 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {},
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/angular/deliver/handler.js

@@ -1,8 +1,15 @@
 import { mountSPA, ErrorHTML } from '#edge';
 
-try {
-  const myApp = await mountSPA(event.request.url, AZION.VERSION_ID);
-  return myApp;
-} catch (e) {
-  return ErrorHTML('404');
+/**
+ * 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 mountSPA(event.request.url, AZION_VERSION_ID);
+    return myApp;
+  } catch (e) {
+    return ErrorHTML('404');
+  }
 }

package/lib/presets/custom/angular/deliver/prebuild.js

@@ -1,20 +1,17 @@
-import { exec, feedback, getPackageManager } from '#utils';
+import { exec, getPackageManager } from '#utils';
 
 const packageManager = await getPackageManager();
 
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
-  try {
-    // This is because npm interprets arguments passed directly
-    // after the script as options for npm itself, not the script itself.
-    const npmArgsForward = packageManager === 'npm' ? '--' : '';
-    // support npm, yarn, pnpm
-    await exec(`${packageManager} run build ${npmArgsForward} --output-path=.edge/statics`, 'Angular', true);
-  } catch (error) {
-    feedback.prebuild.error(error);
-  }
+async function prebuild(buildContext) {
+  // This is because npm interprets arguments passed directly
+  // after the script as options for npm itself, not the script itself.
+  const npmArgsForward = packageManager === 'npm' ? '--' : '';
+  // support npm, yarn, pnpm
+  await exec(`${packageManager} run build ${npmArgsForward} --output-path=.edge/storage`, 'Angular', true);
 }
 
 export default prebuild;

package/lib/presets/custom/astro/deliver/config.js

@@ -3,10 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {},
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/astro/deliver/handler.js

@@ -1,8 +1,15 @@
-import { mountSSG, ErrorHTML } from "#edge";
+import { mountSSG, ErrorHTML } from '#edge';
 
-try {
-  const myApp = await mountSSG(event.request.url, AZION.VERSION_ID);
-  return myApp;
-} catch (error) {
-  return ErrorHTML("404");
-}
+/**
+ * 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 (error) {
+    return ErrorHTML('404');
+  }
+}

package/lib/presets/custom/astro/deliver/prebuild.js

@@ -7,31 +7,28 @@ const packageManager = await getPackageManager();
 
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
-  try {
-    const newOutDir = '.edge/statics';
-    let outDir = 'dist';
+async function prebuild(buildContext) {
+  const newOutDir = '.edge/storage';
+  let outDir = 'dist';
 
-    // check if an output path is specified in config file
-    const configFileContent = await readFile('./astro.config.mjs', 'utf-8');
-    const attributeMatch = Array.from(
-      configFileContent.matchAll(/outDir:(.*)\n/g),
-      (match) => match,
-    )[0];
-    if (attributeMatch) {
-      // get the specified value in config
-      outDir = attributeMatch[1].trim();
-    }
+  // check if an output path is specified in config file
+  const configFileContent = await readFile('./astro.config.mjs', 'utf-8');
+  const attributeMatch = Array.from(
+    configFileContent.matchAll(/outDir:(.*)\n/g),
+    (match) => match,
+  )[0];
+  if (attributeMatch) {
+    // get the specified value in config
+    outDir = attributeMatch[1].trim();
+  }
 
-    await exec(`${packageManager} run build`, 'Astro', true);
+  await exec(`${packageManager} run build`, 'Astro', true);
 
-    // move files to vulcan default path
-    copyDirectory(outDir, newOutDir);
-    rm(outDir, { recursive: true, force: true });
-  } catch (error) {
-    feedback.prebuild.error(error);
-  }
+  // move files to vulcan default path
+  copyDirectory(outDir, newOutDir);
+  rm(outDir, { recursive: true, force: true });
 }
 
 export default prebuild;

package/lib/presets/custom/hexo/deliver/config.js

@@ -3,10 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {},
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/hexo/deliver/handler.js

@@ -1,8 +1,15 @@
-import { mountSSG, ErrorHTML } from "#edge";
+import { mountSSG, ErrorHTML } from '#edge';
 
-try {
-  const myApp = await mountSSG(event.request.url, AZION.VERSION_ID);
-  return myApp;
-} catch (e) {
-  return ErrorHTML("404");
+/**
+ * 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) {
+    return ErrorHTML('404');
+  }
 }

package/lib/presets/custom/hexo/deliver/prebuild.js

@@ -7,31 +7,28 @@ const packageManager = await getPackageManager();
 
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
-  try {
-    const newOutDir = '.edge/statics';
-    let outDir = 'public';
+async function prebuild(buildContext) {
+  const newOutDir = '.edge/storage';
+  let outDir = 'public';
 
-    // check if an output path is specified in config file
-    const configFileContent = await readFile('./_config.yml', 'utf-8');
-    const attributeMatch = Array.from(
-      configFileContent.matchAll(/public_dir:(.*)\n/g),
-      (match) => match,
-    )[0];
-    if (attributeMatch) {
-      // get the specified value in config
-      outDir = attributeMatch[1].trim().replace(/["']/g, '');
-    }
+  // check if an output path is specified in config file
+  const configFileContent = await readFile('./_config.yml', 'utf-8');
+  const attributeMatch = Array.from(
+    configFileContent.matchAll(/public_dir:(.*)\n/g),
+    (match) => match,
+  )[0];
+  if (attributeMatch) {
+    // get the specified value in config
+    outDir = attributeMatch[1].trim().replace(/["']/g, '');
+  }
 
-    await exec(`${packageManager} hexo generate`, 'Hexo', true);
+  await exec(`${packageManager} hexo generate`, 'Hexo', true);
 
-    // move files to vulcan default path
-    copyDirectory(outDir, newOutDir);
-    rm(outDir, { recursive: true, force: true });
-  } catch (error) {
-    feedback.prebuild.error(error);
-  }
+  // move files to vulcan default path
+  copyDirectory(outDir, newOutDir);
+  rm(outDir, { recursive: true, force: true });
 }
 
 export default prebuild;

package/lib/presets/custom/next/deliver/config.js

@@ -3,12 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {
-      distDir: '.edge/statics',
-    },
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/next/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/custom/next/deliver/prebuild.js

@@ -26,11 +26,11 @@ const packageManager = await getPackageManager();
  * @param {string} directory - The root directory to start moving files.
  * @example
  * // Before:
- * // Root directory: '/path/to/project/.edge/statics'
+ * // Root directory: '/path/to/project/.edge/storage'
  * // Files in the directory: ['home.html', 'about.html', 'contact.html', 'styles.css']
  *
- * // After calling moveFiles('/path/to/project/.edge/statics'):
- * // Root directory: '/path/to/project/.edge/statics'
+ * // After calling moveFiles('/path/to/project/.edge/storage'):
+ * // Root directory: '/path/to/project/.edge/storage'
  * // Files in the directory: ['styles.css']
  * // Subdirectory 'home':
  * //   - index.html (previously home.html)
@@ -139,55 +139,52 @@ function validateStaticSiteMode(nextConfig) {
 }
 
 /**
- * Runs custom prebuild actions.
+ * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
-  try {
-    feedback.prebuild.info('Starting Next.js static build process...');
+async function prebuild(buildContext) {
+  feedback.prebuild.info('Starting Next.js static build process...');
 
-    const nextVersion = getPackageVersion('next');
-    feedback.prebuild.info('Detected Next.js version:', nextVersion);
+  const nextVersion = getPackageVersion('next');
+  feedback.prebuild.info('Detected Next.js version:', nextVersion);
 
-    const staticsOutputDir = '.edge/statics';
+  const staticsOutputDir = '.edge/storage';
 
-    if (isANewerVersion(nextVersion)) {
-      const nextConfig = await getNextConfig();
+  if (isANewerVersion(nextVersion)) {
+    const nextConfig = await getNextConfig();
 
-      validateStaticSiteMode(nextConfig);
+    validateStaticSiteMode(nextConfig);
 
-      // check if an output path is specified in config file
-      let outDir = 'out';
-      const configFileContent = await readFile('./next.config.js', 'utf-8');
-      const attributeMatch = Array.from(
-        configFileContent.matchAll(/distDir:(.*),/g),
-        (match) => match,
-      )[0];
-      if (attributeMatch) {
-        // get the specified value in config
-        outDir = attributeMatch[1].trim().replace(/["']/g, '');
-      }
+    // check if an output path is specified in config file
+    let outDir = 'out';
+    const configFileContent = await readFile('./next.config.js', 'utf-8');
+    const attributeMatch = Array.from(
+      configFileContent.matchAll(/distDir:(.*),/g),
+      (match) => match,
+    )[0];
+    if (attributeMatch) {
+      // get the specified value in config
+      outDir = attributeMatch[1].trim().replace(/["']/g, '');
+    }
 
-      await exec(`${packageManager} run build`, true);
+    await exec(`${packageManager} run build`, `Next ${nextVersion}`, true);
 
-      // move files to vulcan default path
-      copyDirectory(outDir, staticsOutputDir);
-      rm(outDir, { recursive: true, force: true });
+    // move files to vulcan default path
+    copyDirectory(outDir, staticsOutputDir);
+    rm(outDir, { recursive: true, force: true });
 
-      feedback.prebuild.info('Adapting Next.js build output...');
-      await moveFiles(`${process.cwd()}/${staticsOutputDir}`);
-    } else {
-      await exec(`${packageManager} run build`, true);
+    feedback.prebuild.info('Adapting Next.js build output...');
+    await moveFiles(`${process.cwd()}/${staticsOutputDir}`);
+  } else {
+    await exec(`${packageManager} run build`, `Next ${nextVersion}`, true);
 
-      await exec(`npx next export -o ${staticsOutputDir}`, true);
+    await exec(`npx next export -o ${staticsOutputDir}`, `Next ${nextVersion}`, true);
 
-      feedback.prebuild.info('Adapting Next.js build output...');
-      await moveFiles(`${process.cwd()}/${staticsOutputDir}`);
-    }
-
-    feedback.prebuild.success('Next.js build adaptation completed successfully.');
-  } catch (error) {
-    feedback.prebuild.error('Error occurred during Next.js build adaptation:', error);
+    feedback.prebuild.info('Adapting Next.js build output...');
+    await moveFiles(`${process.cwd()}/${staticsOutputDir}`);
   }
+
+  feedback.prebuild.success('Next.js build adaptation completed successfully.');
 }
 
 export default prebuild;

package/lib/presets/custom/react/deliver/config.js

@@ -3,10 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {},
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/react/deliver/handler.js

@@ -1,8 +1,15 @@
-import { mountSPA, ErrorHTML } from "#edge";
+import { mountSPA, ErrorHTML } from '#edge';
 
+/**
+ * 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 mountSPA(event.request.url, AZION.VERSION_ID);
+    const myApp = await mountSPA(event.request.url, AZION_VERSION_ID);
     return myApp;
   } catch (e) {
-    return ErrorHTML("404");
+    return ErrorHTML('404');
   }
+}

package/lib/presets/custom/react/deliver/prebuild.js

@@ -1,16 +1,13 @@
-import { exec, feedback, getPackageManager } from '#utils';
+import { exec, getPackageManager } from '#utils';
 
 const packageManager = await getPackageManager();
 
 /**
  * Runs custom prebuild actions
+ * @param {object} buildContext - info about the build
  */
-async function prebuild() {
-  try {
-    await exec(`BUILD_PATH="./.edge/statics" ${packageManager} run build`, 'React', true);
-  } catch (error) {
-    feedback.prebuild.error(error);
-  }
+async function prebuild(buildContext) {
+  await exec(`BUILD_PATH="./.edge/storage" ${packageManager} run build`, 'React', true);
 }
 
 export default prebuild;

package/lib/presets/custom/vue/deliver/config.js

@@ -3,10 +3,8 @@
  */
 const config = {
   builder: 'webpack',
-  webpack: {
-    config: {},
-    plugins: [],
-  },
+  useNodePolyfills: false,
+  custom: {},
 };
 
 export default config;

package/lib/presets/custom/vue/deliver/handler.js

@@ -1,8 +1,15 @@
-import { mountSPA, ErrorHTML } from "#edge";
+import { mountSPA, ErrorHTML } from '#edge';
 
+/**
+ * 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 mountSPA(event.request.url, AZION.VERSION_ID);
+    const myApp = await mountSPA(event.request.url, AZION_VERSION_ID);
     return myApp;
   } catch (e) {
-    return ErrorHTML("404");
+    return ErrorHTML('404');
   }
+}

package/lib/presets/custom/vue/deliver/prebuild.js

@@ -1,19 +1,75 @@
-import { exec, feedback, getPackageManager } from '#utils';
+import {
+  exec, getPackageManager, copyDirectory,
+} from '#utils';
+import { lstat, readFile, rm } from 'fs/promises';
+import { join } from 'path';
 
 const packageManager = await getPackageManager();
+const edgeStorageDir = '.edge/storage';
+const defaultViteOutDir = 'dist';
 
 /**
- * Runs custom prebuild actions
+ * Check if the vite.config.js file exists.
+ * @returns {boolean} True if the file exists, false otherwise.
  */
-async function prebuild() {
+async function viteConfigExists() {
   try {
-    // This is because npm interprets arguments passed directly
-    // after the script as options for npm itself, not the script itself.
-    const npmArgsForward = packageManager === 'npm' ? '--' : '';
-    // support npm, yarn, pnpm
-    await exec(`${packageManager} run build ${npmArgsForward} --dest .edge/statics`, 'Vue', true);
-  } catch (error) {
-    feedback.prebuild.error(error);
+    await lstat('./vite.config.js');
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+/**
+ * Read and parse the vite.config.js file.
+ * @returns {object} The parsed configuration object or null if the file doesn't exist.
+ */
+async function readViteConfig() {
+  try {
+    const configFileContent = await readFile('./vite.config.js', 'utf-8');
+    return JSON.parse(configFileContent.replace(/^module.exports = /, ''));
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * Runs custom prebuild actions.
+ */
+async function prebuild() {
+  const npmArgsForward = packageManager === 'npm' ? '--' : '';
+
+  let outDir = defaultViteOutDir;
+  let destPath = edgeStorageDir;
+
+  const isViteProject = await viteConfigExists();
+
+  if (isViteProject) {
+    await exec(
+      `${packageManager} run build ${npmArgsForward}`,
+      'Vue/Vite',
+      true,
+    );
+
+    const config = await readViteConfig();
+
+    if (config?.build?.outDir) {
+      outDir = config.build.outDir;
+    }
+
+    const srcPath = join('.', outDir);
+    destPath = join(edgeStorageDir);
+    copyDirectory(outDir, srcPath);
+    rm(outDir, { recursive: true, force: true });
+  }
+
+  if (!isViteProject) {
+    await exec(
+      `${packageManager} run build ${npmArgsForward} --dest ${destPath}`,
+      'Vue',
+      true,
+    );
   }
 }
 

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

@@ -4,10 +4,7 @@
 const config = {
   builder: 'webpack',
   useNodePolyfills: false,
-  custom: {
-    config: {},
-    plugins: [],
-  },
+  custom: {},
 };
 
 export default config;