edge-functions 1.0.0

package/lib/platform/services/tokens.service.js

@@ -0,0 +1,55 @@
+import BaseService from './base.service.js';
+
+/**
+ * Service class for managing tokens.
+ * Extends the BaseService class.
+ */
+class TokensService extends BaseService {
+  /**
+   * Constructs an instance of TokensService.
+   * Initializes the base URL for tokens.
+   */
+  constructor() {
+    super('/tokens');
+  }
+
+  /**
+   * Creates a new token.
+   * @param {string} username - The username for authentication.
+   * @param {string} password - The password for authentication.
+   * @returns {Promise} A promise that resolves to the created token.
+   */
+  create(username, password) {
+    const base64Credentials = Buffer.from(`${username}:${password}`).toString('base64');
+    return super.post('', '', {
+      headers: {
+        Authorization: `Basic ${base64Credentials}`,
+      },
+    });
+  }
+}
+
+/**
+ * @name TokensService
+ * @memberof Services
+ * Instance of the Tokens Service.
+ * This instance provides methods to interact with Azion's Tokens service,
+ * such as creating a new token for authentication.
+ * @type {BaseService}
+ * @function create
+ * @example
+ *
+ * // Example usage
+ * const username = 'myUsername';
+ * const password = 'myPassword';
+ *
+ * TokensService.create(username, password)
+ *   .then((token) => {
+ *     console.log(token);
+ *   })
+ *   .catch((error) => {
+ *     feedback.error(error);
+ *   });
+ */
+const TokensServiceInstance = new TokensService();
+export default TokensServiceInstance;

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

@@ -0,0 +1,12 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {},
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,8 @@
+import { mountSPA, ErrorHTML } from '#edge';
+
+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

@@ -0,0 +1,20 @@
+import { exec, feedback, getPackageManager } from '#utils';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Runs custom prebuild actions
+ */
+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);
+  }
+}
+
+export default prebuild;

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

@@ -0,0 +1,12 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {},
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,8 @@
+import { mountSSG, ErrorHTML } from "#edge";
+
+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

@@ -0,0 +1,37 @@
+import { rm, readFile } from 'fs/promises';
+import {
+  exec, getPackageManager, feedback, copyDirectory,
+} from '#utils';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Runs custom prebuild actions
+ */
+async function prebuild() {
+  try {
+    const newOutDir = '.edge/statics';
+    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();
+    }
+
+    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);
+  }
+}
+
+export default prebuild;

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

@@ -0,0 +1,12 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {},
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,8 @@
+import { mountSSG, ErrorHTML } from "#edge";
+
+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

@@ -0,0 +1,37 @@
+import { readFile, rm } from 'fs/promises';
+import {
+  exec, getPackageManager, feedback, copyDirectory,
+} from '#utils';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Runs custom prebuild actions
+ */
+async function prebuild() {
+  try {
+    const newOutDir = '.edge/statics';
+    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, '');
+    }
+
+    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);
+  }
+}
+
+export default prebuild;

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

@@ -0,0 +1,14 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {
+      distDir: '.edge/statics',
+    },
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,9 @@
+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)
+}

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

@@ -0,0 +1,193 @@
+import { gte, coerce, valid } from 'semver';
+import {
+  exec, feedback, getPackageManager, getPackageVersion, copyDirectory,
+} from '#utils';
+
+import {
+  readdir, stat, rename, mkdir, readFile, rm,
+} from 'fs/promises';
+import {
+  join, extname, basename, dirname,
+} from 'path';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Moves HTML and corresponding TXT files to subdirectories and
+ * renames the HTML files to 'index.html'.
+ * This function is used to organize the static files generated by Next.js during the build process.
+ * It looks for HTML files in the specified directory and its subdirectories.
+ * When it finds an HTML file,
+ * it creates a new subdirectory with the same name as the HTML file (without the .html extension),
+ * and moves the HTML file to that subdirectory, renaming it to 'index.html'.
+ * If there is a corresponding TXT file with the same base name (before .html extension),
+ * it will also be moved
+ * to the same subdirectory with its original name.
+ * @param {string} directory - The root directory to start moving files.
+ * @example
+ * // Before:
+ * // Root directory: '/path/to/project/.edge/statics'
+ * // 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'
+ * // Files in the directory: ['styles.css']
+ * // Subdirectory 'home':
+ * //   - index.html (previously home.html)
+ * //   - home.txt
+ * // Subdirectory 'about':
+ * //   - index.html (previously about.html)
+ * //   - about.txt
+ * // Subdirectory 'contact':
+ * //   - index.html (previously contact.html)
+ * //   - contact.txt
+ */
+async function moveFiles(directory) {
+  const files = await readdir(directory);
+
+  await Promise.all(
+    files.map(async (file) => {
+      const filePath = join(directory, file);
+      const fileStat = await stat(filePath);
+
+      if (fileStat.isDirectory()) {
+        await moveFiles(filePath); // Recursive call for subdirectories
+      } else if (
+        extname(file) === '.html'
+        && file !== 'index.html'
+        && file !== '404.html'
+      ) {
+        const newDirectoryName = basename(file, '.html');
+        const newDirectoryPath = join(directory, newDirectoryName);
+
+        await mkdir(newDirectoryPath, { recursive: true });
+
+        const newHTMLPath = join(newDirectoryPath, 'index.html');
+        await rename(filePath, newHTMLPath);
+        feedback.prebuild.info(`Moved ${filePath} to ${newHTMLPath}`);
+
+        const correspondingTXTFile = `${basename(file, '.html')}.txt`;
+        const correspondingTXTPath = join(directory, correspondingTXTFile);
+
+        if (files.includes(correspondingTXTFile)) {
+          const newTXTParentDirectory = dirname(newHTMLPath);
+          const newTXTPath = join(newTXTParentDirectory, correspondingTXTFile);
+          await rename(correspondingTXTPath, newTXTPath);
+          feedback.prebuild.info(`Moved ${correspondingTXTPath} to ${newTXTPath}`);
+        }
+      }
+    }),
+  );
+}
+
+/**
+ * Detect if version is >= 13.3.0
+ * In this version the static site had significant changes in how to use and how to build.
+ * doc reference:
+ * https://nextjs.org/docs/pages/building-your-application/deploying/static-exports
+ * @param {string} version - Next.js version ("latest" or in "x.x.x" format).
+ * @returns {boolean} - a boolean indicating if is a recent version or not.
+ * @example
+ * isANewerVersion('^14.2.3') returns true.
+ * isANewerVersion('~13.0.0') returns false.
+ * isANewerVersion('*') returns true.
+ * isANewerVersion('>returns13.3.0<14.0.0') returns true.
+ * isANewerVersion('13.x') returns false.
+ * isANewerVersion('>=12.0<13') returns false.
+ * isANewerVersion('13.4') returns true.
+ * isANewerVersion('latest') returns true.
+ * isANewerVersion('x') returns true.
+ * isANewerVersion('11') returns false.
+ */
+function isANewerVersion(version) {
+  if (['latest', '*', 'x', 'X'].includes(version)) {
+    return true;
+  }
+
+  const targetVersion = '13.3.0';
+  // use semver to check if is a greater or equal version
+  if (gte(valid(coerce(version)), targetVersion)) {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Get next config file
+ * @returns {object} - next config as a JSON
+ */
+async function getNextConfig() {
+  try {
+    const configPath = join(process.cwd(), 'next.config.js');
+    const configModule = await import(configPath);
+
+    return configModule.default;
+  } catch (error) {
+    throw Error('Error reading next config file:', error);
+  }
+}
+
+/**
+ * Validates if static site mode is enabled in next config.
+ * @param {object} nextConfig - the config as JSON object.
+ */
+function validateStaticSiteMode(nextConfig) {
+  if (!nextConfig.output || nextConfig.output !== 'export') {
+    throw Error('Static site mode not enabled in config!');
+  }
+}
+
+/**
+ * Runs custom prebuild actions.
+ */
+async function prebuild() {
+  try {
+    feedback.prebuild.info('Starting Next.js static build process...');
+
+    const nextVersion = getPackageVersion('next');
+    feedback.prebuild.info('Detected Next.js version:', nextVersion);
+
+    const staticsOutputDir = '.edge/statics';
+
+    if (isANewerVersion(nextVersion)) {
+      const nextConfig = await getNextConfig();
+
+      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, '');
+      }
+
+      await exec(`${packageManager} run build`, 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);
+
+      await exec(`npx next export -o ${staticsOutputDir}`, 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);
+  }
+}
+
+export default prebuild;

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

@@ -0,0 +1,12 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {},
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,8 @@
+import { mountSPA, ErrorHTML } from "#edge";
+
+  try {
+    const myApp = await mountSPA(event.request.url, AZION.VERSION_ID);
+    return myApp;
+  } catch (e) {
+    return ErrorHTML("404");
+  }

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Config to be used in build context.
+ */
+const config = {
+  builder: 'webpack',
+  webpack: {
+    config: {},
+    plugins: [],
+  },
+};
+
+export default config;

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

@@ -0,0 +1,8 @@
+import { mountSPA, ErrorHTML } from "#edge";
+
+  try {
+    const myApp = await mountSPA(event.request.url, AZION.VERSION_ID);
+    return myApp;
+  } catch (e) {
+    return ErrorHTML("404");
+  }

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

@@ -0,0 +1,20 @@
+import { exec, feedback, getPackageManager } from '#utils';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Runs custom prebuild actions
+ */
+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} --dest .edge/statics`, 'Vue', true);
+  } catch (error) {
+    feedback.prebuild.error(error);
+  }
+}
+
+export default prebuild;

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

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

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

@@ -0,0 +1,9 @@
+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)
+}

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

@@ -0,0 +1,15 @@
+import { join } from 'path';
+
+import { copyDirectory } from '#utils';
+
+/**
+ * Runs custom prebuild actions
+ */
+async function prebuild() {
+  const sourceDir = process.cwd();
+  const targetDir = join('.', '.edge', 'statics');
+
+  copyDirectory(sourceDir, targetDir);
+}
+
+export default prebuild;

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

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

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

@@ -0,0 +1,5 @@
+try {
+  __JS_CODE__;
+} catch (e) {
+  return new Response(e.message || e.toString(), { status: 500 });
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Runs custom prebuild actions
+ */
+function prebuild() {}
+
+export default prebuild;

package/lib/providers/azion/worker.js

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

package/lib/utils/copyDirectory/copyDirectory.utils.js

@@ -0,0 +1,54 @@
+import {
+  existsSync, mkdirSync, readdirSync, lstatSync, copyFileSync,
+} from 'fs';
+import { join, resolve } from 'path';
+
+/**
+ * Recursively copies a directory to the target directory, excluding any files or directories
+ * that would result in the target directory being copied into itself.
+ * @function
+ * @name copyDirectory
+ * @memberof utils
+ * @param {string} source - The path of the source directory.
+ * @param {string} target - The path of the target directory. If the target directory is a
+ * subdirectory of the source directory, this function will avoid copying the target directory into
+ * itself.
+ * @example
+ * // Copy a directory to the target directory
+ * copyDirectory('path/to/source', 'path/to/target');
+ * @example
+ * // If the target directory is a subdirectory
+ * of the source directory, this function will avoid copying the target directory into itself
+ * copyDirectory('path/to/source', 'path/to/source/subdirectory');
+ */
+function copyDirectory(source, target) {
+  const absoluteSource = resolve(source);
+  const absoluteTarget = resolve(target);
+
+  // Do not copy if source and target are the same
+  if (absoluteSource === absoluteTarget) { return; }
+
+  if (!existsSync(absoluteTarget)) {
+    mkdirSync(absoluteTarget, { recursive: true });
+  }
+
+  const files = readdirSync(absoluteSource);
+
+  files.forEach((file) => {
+    const sourcePath = join(absoluteSource, file);
+    const targetPath = join(absoluteTarget, file);
+
+    // If the target path is a subdirectory of the source path, skip copying
+    if (targetPath.startsWith(sourcePath)) { return; }
+
+    const fileStat = lstatSync(sourcePath);
+
+    if (fileStat.isDirectory()) {
+      copyDirectory(sourcePath, targetPath);
+    } else {
+      copyFileSync(sourcePath, targetPath);
+    }
+  });
+}
+
+export default copyDirectory;