edge-functions 2.10.0 → 2.11.0-stage.2

package/.prettierignore

@@ -5,4 +5,5 @@ CHANGELOG.md
 docker-compose.yml
 CODEOWNERS
 README.md
-docs/*
+docs/*
+lib/build/bundlers/polyfills/node/fs.js

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.11.0-stage.2](https://github.com/aziontech/vulcan/compare/v2.11.0-stage.1...v2.11.0-stage.2) (2024-07-09)
+
+
+### Features
+
+* New preset Docusaurus ([#353](https://github.com/aziontech/vulcan/issues/353)) ([0c05e76](https://github.com/aziontech/vulcan/commit/0c05e76955afa500adc5c7e8762d007725c9b58b))
+
+## [2.11.0-stage.1](https://github.com/aziontech/vulcan/compare/v2.10.0...v2.11.0-stage.1) (2024-07-08)
+
+
+### Features
+
+* use runtime in async fs ([#352](https://github.com/aziontech/vulcan/issues/352)) ([6a6f195](https://github.com/aziontech/vulcan/commit/6a6f19543a31ab9d39efbc4eb165fa6b2780c95e))
+
 ## [2.10.0](https://github.com/aziontech/vulcan/compare/v2.9.2...v2.10.0) (2024-07-02)
 
 

package/lib/build/bundlers/esbuild/plugins/azion-polyfills/azion-polyfills.plugins.test.js

@@ -1,6 +1,8 @@
 import * as esbuild from 'esbuild';
 import ESBuildAzionModulePlugin from './azion-polyfills.plugins.js';
 
+globalThis.vulcan = { buildProd: true };
+
 describe('Esbuild Azion Plugin', () => {
   it('should resolve the azion module: as external', async () => {
     const results = await esbuild.build({

package/lib/build/bundlers/esbuild/plugins/node-polyfills/node-polyfills.plugins.test.js

@@ -1,6 +1,8 @@
 import * as esbuild from 'esbuild';
 import ESBuildNodeModulePlugin from './node-polyfills.plugins.js';
 
+globalThis.vulcan = { buildProd: true };
+
 describe('Esbuild Node Plugin', () => {
   it('should check the env (NODE_ENV) in define options', async () => {
     const results = await esbuild.build({

package/lib/build/bundlers/polyfills/node/fs.js

@@ -1,5 +1,5 @@
 /* eslint-disable max-classes-per-file */
-import path from 'path-browserify';
+import bPath from 'path-browserify';
 import { Buffer } from 'buffer';
 
 /* eslint-disable */
@@ -12,12 +12,10 @@ globalThis.vulcan.FS_PATHS_CHANGED = false;
  * fix mapped files paths based on path prefix
  */
 function fixMappedFilesPaths() {
-  if (
-    !globalThis.vulcan.FS_PATHS_CHANGED &&
-    globalThis.vulcan.FS_PATH_PREFIX_TO_REMOVE !== ''
-  ) {
+  const prefix = globalThis.vulcan.FS_PATH_PREFIX_TO_REMOVE;
+  if (!globalThis.vulcan.FS_PATHS_CHANGED && prefix !== "") {
     Object.keys(MEM_FILES).forEach((e) => {
-      const newKey = e.replace(globalThis.vulcan.FS_PATH_PREFIX_TO_REMOVE, '');
+      const newKey = e.replace(prefix, '');
       MEM_FILES[newKey] = MEM_FILES[e];
       delete MEM_FILES[e];
     });
@@ -56,7 +54,9 @@ function getFileContent(file, returnBuffer = true) {
  * @returns {string[]} list of mapped files paths
  */
 function getAvailableFiles() {
-  if (MEM_FILES && typeof MEM_FILES === 'object') return Object.keys(MEM_FILES);
+  if (MEM_FILES && typeof MEM_FILES === 'object') {
+    return Object.keys(MEM_FILES);
+  }
 
   return [];
 }
@@ -71,12 +71,12 @@ function getAvailableDirs(files) {
     const existingDirs = new Set();
 
     files.forEach((filePath) => {
-      const dirPath = path.dirname(filePath);
+      const dirPath = bPath.dirname(filePath);
 
       let currentPath = '/';
       let pathSegments = dirPath.split('/');
       for (let i = 0; i < pathSegments.length; i++) {
-        currentPath = path.join(currentPath, pathSegments[i]);
+        currentPath = bPath.join(currentPath, pathSegments[i]);
         if (!existingDirs.has(currentPath)) {
           existingDirs.add(currentPath);
         }
@@ -113,8 +113,13 @@ function getFilesInfos() {
  * @returns {string} - path to fix
  */
 function getValidatedPath(path) {
-  if (path.endsWith('/')) path = path.slice(0, -1);
-  if (!path.startsWith('/')) path = `/${path}`;
+  if (path.endsWith('/')) {
+    path = path.slice(0, -1);
+  }
+
+  if (!path.startsWith('/')) {
+    path = bPath.join('/', path);
+  }
 
   return path;
 }
@@ -147,12 +152,6 @@ function generateDefaultStat() {
 // ### fs polyfills
 // code based on node implementations
 
-const UV_FS_SYMLINK_DIR = 1;
-const UV_FS_SYMLINK_JUNCTION = 2;
-const O_RDONLY = 0;
-const O_WRONLY = 1;
-const O_RDWR = 2;
-const UV_DIRENT_UNKNOWN = 0;
 const UV_DIRENT_FILE = 1;
 const UV_DIRENT_DIR = 2;
 const UV_DIRENT_LINK = 3;
@@ -160,53 +159,10 @@ const UV_DIRENT_FIFO = 4;
 const UV_DIRENT_SOCKET = 5;
 const UV_DIRENT_CHAR = 6;
 const UV_DIRENT_BLOCK = 7;
-const S_IFMT = 61440;
-const S_IFREG = 32768;
-const S_IFDIR = 16384;
-const S_IFCHR = 8192;
-const S_IFBLK = 24576;
-const S_IFIFO = 4096;
-const S_IFLNK = 40960;
-const S_IFSOCK = 49152;
-const O_CREAT = 512;
-const O_EXCL = 2048;
-const UV_FS_O_FILEMAP = 0;
-const O_NOCTTY = 131072;
-const O_TRUNC = 1024;
-const O_APPEND = 8;
-const O_DIRECTORY = 1048576;
-const O_NOFOLLOW = 256;
-const O_SYNC = 128;
-const O_DSYNC = 4194304;
-const O_SYMLINK = 2097152;
-const O_NONBLOCK = 4;
-const S_IRWXU = 448;
-const S_IRUSR = 256;
-const S_IWUSR = 128;
-const S_IXUSR = 64;
-const S_IRWXG = 56;
-const S_IRGRP = 32;
-const S_IWGRP = 16;
-const S_IXGRP = 8;
-const S_IRWXO = 7;
-const S_IROTH = 4;
-const S_IWOTH = 2;
-const S_IXOTH = 1;
-const F_OK = 0;
-const R_OK = 4;
-const W_OK = 2;
-const X_OK = 1;
-const UV_FS_COPYFILE_EXCL = 1;
-const COPYFILE_EXCL = 1;
-const UV_FS_COPYFILE_FICLONE = 2;
-const COPYFILE_FICLONE = 2;
-const UV_FS_COPYFILE_FICLONE_FORCE = 4;
-const COPYFILE_FICLONE_FORCE = 4;
 
 const kType = Symbol('type');
-const kStats = Symbol('stats');
 
-class Dirent {
+class CustomDirent {
   constructor(name, type, path) {
     this.name = name;
     this.path = path;
@@ -242,27 +198,12 @@ class Dirent {
   }
 }
 
-class DirentFromStats extends Dirent {
-  constructor(name, stats, path) {
-    super(name, null, path);
-    this[kStats] = stats;
-  }
-}
-
 const kEmptyObject = { __proto__: null };
 
 function defaultCloseCallback(err) {
   if (err != null) throw err;
 }
 
-function maybeCallback(cb) {
-  if (typeof cb !== 'function') {
-    throw new Error('Param is not a function!');
-  }
-
-  return cb;
-}
-
 function assertEncoding(encoding) {
   if (encoding && !Buffer.isEncoding(encoding)) {
     throw new Error('Invalid encoding!');
@@ -313,45 +254,6 @@ function closeSync(fd) {
   // (In-memory implementation doesn't require explicit closing)
 }
 
-/**
- * Asynchronously opens a file.
- * @param {string | Buffer | URL} path
- * @param {string | number} [flags='r']
- * @param {string | number} [mode=0o666]
- * @param {function(Error, number): any} [callback]
- * @returns {void}
- */
-function open(path, flags, mode, callback) {
-  // handle function args (code from node)
-  if (arguments.length < 3) {
-    callback = flags;
-    flags = 'r';
-    mode = 0o666;
-  } else if (typeof mode === 'function') {
-    callback = mode;
-    mode = 0o666;
-  } else {
-    mode = '0o666';
-  }
-
-  setTimeout(() => {
-    path = getValidatedPath(path);
-    const file = getFile(path);
-    if (file !== undefined) {
-      const fileDescriptor = Symbol(`File Descriptor for ${path}`);
-
-      callback(null, fileDescriptor);
-    } else {
-      const error = new Error(
-        `ENOENT: no such file or directory, fs.open call for path '${path}'`,
-      );
-      error.code = 'ENOENT';
-
-      callback(error);
-    }
-  }, 0);
-}
-
 /**
  * Synchronously opens a file.
  * @param {string | Buffer | URL} path
@@ -376,47 +278,6 @@ function openSync(path, flags, mode) {
   }
 }
 
-/**
- * Asynchronously gets the stats of a file.
- * @param {string | Buffer | URL} path
- * @param {Object} [options] - Options object.
- * @param {boolean} [options.bigint=false]
- * @param {function(Error, any): any} [callback]
- * @returns {void}
- */
-async function stat(path, options = { bigint: false }, callback) {
-  // handle function args (code from node)
-  if (typeof options === 'function') {
-    callback = options;
-    options = kEmptyObject;
-  }
-
-  path = getValidatedPath(path);
-
-  setTimeout(() => {
-    const filesInfos = getFilesInfos();
-    if (!filesInfos.paths.includes(path)) {
-      const error = new Error(
-        `ENOENT: no such file or directory, fs.stat call for path '${path}'`,
-      );
-      error.code = 'ENOENT';
-      callback(error);
-    }
-
-    const file = getFile(path);
-    const isFile = filesInfos.files.includes(path);
-    const size = isFile ? file.content.length : 0;
-
-    // generate file informations
-    const stats = generateDefaultStat();
-    stats.size = size;
-    stats.isFile = () => isFile;
-    stats.isDirectory = () => !isFile;
-
-    callback(null, stats);
-  }, 0);
-}
-
 /**
  * Synchronously retrieves the `fs.Stats`
  * for the `path`.
@@ -426,7 +287,7 @@ async function stat(path, options = { bigint: false }, callback) {
  * @param {boolean} [options.throwIfNoEntry]
  * @returns {any}
  */
-function statSync(path, options) {
+function statSync(path, options = {}) {
   // checks final
   path = getValidatedPath(path);
 
@@ -454,46 +315,6 @@ function statSync(path, options) {
   return stats;
 }
 
-/**
- * Asynchronously reads the entire contents of a file.
- * @param {string | Buffer | URL | number} path
- * @param {Object | string} [options] - Options object or encoding string.
- * @param {string} [options.encoding] - The file encoding.
- * @param {string} [options.flag] - The flag.
- * @param {AbortSignal} [options.signal] - The signal.
- * @param {function(Error, (string | Buffer))} callback - Callback function.
- * @returns {void}
- */
-function readFile(path, options, callback) {
-  // handle function args
-  if (typeof options === 'function') {
-    callback = options;
-    options = { ...kEmptyObject };
-  }
-  callback = maybeCallback(callback || options);
-  options = getOptions(options, { flag: 'r' });
-  path = getValidatedPath(path);
-
-  setTimeout(() => {
-    const file = getFile(path);
-    if (file !== undefined) {
-      let content;
-      if (options?.encoding === 'utf-8') {
-        content = getFileContent(file, false);
-      } else {
-        content = getFileContent(file, true);
-      }
-      callback(null, content);
-    } else {
-      const error = new Error(
-        `ENOENT: no such file or directory, fs.readFile call for path '${path}'`,
-      );
-      error.code = 'ENOENT';
-      callback(error);
-    }
-  }, 0);
-}
-
 /**
  * Synchronously reads the entire contents of a file.
  * @param {string | Buffer | URL | number} path
@@ -502,7 +323,7 @@ function readFile(path, options, callback) {
  * @param {string} [options.flag] - The flag.
  * @returns {string | Buffer}
  */
-function readFileSync(path, options) {
+function readFileSync(path, options = {}) {
   path = getValidatedPath(path);
   options = getOptions(options, { flag: 'r' });
 
@@ -531,7 +352,7 @@ function readFileSync(path, options) {
  * @param {boolean} [options.withFileTypes] - Whether to include file types.
  * @param {boolean} [options.recursive] - Whether to include subdirectories.
  */
-function readdirSync(path, options) {
+function readdirSync(path, options = {}) {
   path = getValidatedPath(path);
 
   const filesInfos = getFilesInfos();
@@ -569,7 +390,7 @@ function readdirSync(path, options) {
       const name = element;
       const isFile = filesInfos.files.includes(`${path}/${element}`);
       const type = isFile ? UV_DIRENT_FILE : UV_DIRENT_DIR;
-      return new Dirent(name, type, `${path}/${element}`);
+      return new CustomDirent(name, type, `${path}/${element}`);
     });
   } else {
     result = elementsInDir;
@@ -578,35 +399,126 @@ function readdirSync(path, options) {
   return result;
 }
 
-const promises = { readFile, stat };
+// Use Cells node:fs API
+const fsPolyfill = Object.create(SRC_NODE_FS);
+fsPolyfill.close = close;
+fsPolyfill.closeSync = closeSync;
+fsPolyfill.openSync = openSync;
+fsPolyfill.statSync = statSync;
+fsPolyfill.lstatSync = statSync;
+fsPolyfill.readFileSync = readFileSync;
+fsPolyfill.readdirSync = readdirSync;
 
-const fs = {
-  close,
-  closeSync,
-  open,
-  openSync,
-  stat,
-  statSync,
-  lstatSync: statSync,
-  readFile,
-  readFileSync,
-  readdirSync,
-  promises,
-};
-
-export default fs;
+export default fsPolyfill;
 
 export {
   close,
   closeSync,
-  open,
   openSync,
-  stat,
   statSync,
   statSync as lstatSync,
-  readFile,
   readFileSync,
   readdirSync,
-  promises,
 };
+
+export const {
+  access,
+  accessSync,
+  appendFile,
+  appendFileSync,
+  chmod,
+  chmodSync,
+  chown,
+  chownSync,
+  constants,
+  copyFile,
+  copyFileSync,
+  cp,
+  cpSync,
+  createReadStream,
+  createWriteStream,
+  Dir,
+  Dirent,
+  exists,
+  existsSync,
+  F_OK,
+  fdatasync,
+  fdatasyncSync,
+  fstat,
+  fstatSync,
+  fsync,
+  fsyncSync,
+  ftruncate,
+  ftruncateSync,
+  futimes,
+  futimesSync,
+  link,
+  linkSync,
+  lstat,
+  mkdir,
+  mkdirSync,
+  mkdtemp,
+  mkdtempSync,
+  O_APPEND,
+  O_CREAT,
+  O_DIRECTORY,
+  O_DSYNC,
+  O_EXCL,
+  O_NOCTTY,
+  O_NOFOLLOW,
+  O_NONBLOCK,
+  O_RDONLY,
+  O_RDWR,
+  O_SYMLINK,
+  O_SYNC,
+  O_TRUNC,
+  O_WRONLY,
+  open,
+  opendir,
+  opendirSync,
+  read,
+  readSync,
+  promises,
+  R_OK,
+  readdir,
+  readFile,
+  readlink,
+  readlinkSync,
+  ReadStream,
+  realpath,
+  realpathSync,
+  readv,
+  readvSync,
+  rename,
+  renameSync,
+  rmdir,
+  rmdirSync,
+  rm,
+  rmSync,
+  stat,
+  Stats,
+  statfs,
+  statfsSync,
+  symlink,
+  symlinkSync,
+  truncate,
+  truncateSync,
+  unlink,
+  unlinkSync,
+  unwatchFile,
+  utimes,
+  utimesSync,
+  W_OK,
+  watch,
+  watchFile,
+  write,
+  writeFile,
+  writev,
+  writevSync,
+  writeFileSync,
+  WriteStream,
+  writeSync,
+  X_OK,
+} = SRC_NODE_FS;
+
 /* eslint-enable */

package/lib/build/bundlers/polyfills/polyfills-manager.js

@@ -96,7 +96,6 @@ class PolyfillsManager {
     this.setLib('dgram', `${nodePolyfillsPath}/_empty.js`);
     this.setLib('dns', `${nodePolyfillsPath}/dns.js`);
     this.setLib('events', require.resolve('events/'));
-    this.setLib('fs', `${nodePolyfillsPath}/fs.js`);
     this.setLib('http', require.resolve('stream-http'));
     this.setLib('http2', `${nodePolyfillsPath}/http2.js`);
     this.setLib('https', require.resolve('stream-http'));
@@ -169,6 +168,18 @@ class PolyfillsManager {
       `${externalPolyfillsPath}/azion/network-list/network-list.polyfills.js`,
     );
 
+    // fs temp solution for hybrid implementation (polyfill + runtime)
+    if (globalThis.vulcan.buildProd) {
+      this.setLib('fs', `${nodePolyfillsPath}/fs.js`);
+      this.setExternal('fs/promises', `${nodePolyfillsPath}/fs.promises.js`);
+    } else {
+      this.setExternal(
+        'fs/promises',
+        `${externalPolyfillsPath}/fs/promises.polyfills.js`,
+      );
+      this.setExternal('fs', `${externalPolyfillsPath}/fs/fs.polyfills.js`);
+    }
+
     return {
       libs: this.libs,
       globals: this.globals,

package/lib/build/bundlers/polyfills/polyfills-manager.test.js

@@ -1,9 +1,11 @@
 import { expect, it } from '@jest/globals';
 import PolyfillsManager from './index.js';
 
+globalThis.vulcan = { buildProd: true };
+
 describe('Polyfills Manager', () => {
   it('Should return map of polyfills', () => {
-    const expectedPolyfills = [
+    const expectedPolyfills = new Set([
       'accepts',
       'buffer',
       'child_process',
@@ -43,10 +45,10 @@ describe('Polyfills Manager', () => {
       'zlib',
       'next/dist/compiled/etag',
       '@fastly/http-compute-js',
-    ];
-    const arraylistOfAvailablePolyfills = Array.from(
+    ]);
+    const listOfAvailablePolyfills = new Set(
       PolyfillsManager.buildPolyfills().libs.keys(),
     );
-    expect(arraylistOfAvailablePolyfills).toEqual(expectedPolyfills);
+    expect(listOfAvailablePolyfills).toEqual(expectedPolyfills);
   });
 });

package/lib/build/bundlers/webpack/plugins/azion-polyfills/azion-polyfills.plugins.test.js

@@ -4,6 +4,8 @@ import fs from 'fs';
 import tmp from 'tmp';
 import AzionPolyfillPlugin from './azion-polyfills.plugins.js';
 
+globalThis.vulcan = { buildProd: true };
+
 describe('Webpack Azion Plugin', () => {
   let tmpDir;
   let tmpEntry;

package/lib/build/bundlers/webpack/plugins/node-polyfills/node-polyfills.plugins.test.js

@@ -4,6 +4,8 @@ import fs from 'fs';
 import tmp from 'tmp';
 import NodePolyfillPlugin from './node-polyfills.plugins.js';
 
+globalThis.vulcan = { buildProd: true };
+
 describe('Webpack Node Plugin', () => {
   let tmpDir;
   let tmpEntry;

package/lib/build/dispatcher/dispatcher.js

@@ -416,7 +416,7 @@ class Dispatcher {
         typeof removePathPrefix === 'string' &&
         removePathPrefix !== ''
           ? `${removePathPrefix}`
-          : `''`;
+          : `""`;
 
       copyFilesToFS(injectionDirs, prefix);
       // eslint-disable-next-line
@@ -547,6 +547,18 @@ class Dispatcher {
           feedback.postbuild.info('Running postbuild actions...');
           await postbuild(buildConfig);
         }
+
+        // fs temp solution for hybrid implementation (polyfill + runtime)
+        if (this.useNodePolyfills) {
+          const outPath = '.edge/worker.js';
+          const content = readFileSync(outPath, 'utf-8');
+          let codeToAdd = '';
+          if (globalThis.vulcan.buildProd) {
+            codeToAdd = 'import SRC_NODE_FS from "node:fs";\n';
+          }
+          const newContent = `${codeToAdd}${content}`;
+          writeFileSync(outPath, newContent);
+        }
       }
       // manifest
       const azionConfigPath = await getAzionConfigPath();

package/lib/env/polyfills/fs/context/fs.context.js

@@ -0,0 +1,90 @@
+/* eslint-disable */
+
+import fs from 'fs';
+
+const localFs = {};
+
+export const {
+  open,
+  openSync,
+  close,
+  closeSync,
+  stat,
+  statSync,
+  lstat,
+  lstatSync,
+  readFile,
+  readFileSync,
+  readdir,
+  readdirSync,
+  mkdir,
+  rmdir,
+  copyFile,
+  cp,
+  Dir,
+  Dirent,
+  Stats,
+  constants,
+  F_OK,
+  O_APPEND,
+  O_CREAT,
+  O_DIRECTORY,
+  O_DSYNC,
+  O_EXCL,
+  O_NOCTTY,
+  O_NOFOLLOW,
+  O_NONBLOCK,
+  O_RDONLY,
+  O_RDWR,
+  O_SYMLINK,
+  O_SYNC,
+  O_TRUNC,
+  O_WRONLY,
+  R_OK,
+  W_OK,
+  X_OK,
+} = fs;
+
+export { promises } from 'fs';
+localFs.promises = fs.promises;
+
+localFs.open = open;
+localFs.openSync = openSync;
+localFs.close = close;
+localFs.closeSync = closeSync;
+localFs.stat = stat;
+localFs.statSync = statSync;
+localFs.lstat = lstat;
+localFs.lstatSync = lstatSync;
+localFs.readFile = readFile;
+localFs.readFileSync = readFileSync;
+localFs.readdir = readdir;
+localFs.readdirSync = readdirSync;
+localFs.mkdir = mkdir;
+localFs.rmdir = rmdir;
+localFs.copyFile = copyFile;
+localFs.cp = cp;
+localFs.Dir = Dir;
+localFs.Dirent = Dirent;
+localFs.Stats = Stats;
+localFs.constants = constants;
+localFs.F_OK = F_OK;
+localFs.O_APPEND = O_APPEND;
+localFs.O_CREAT = O_CREAT;
+localFs.O_DIRECTORY = O_DIRECTORY;
+localFs.O_DSYNC = O_DSYNC;
+localFs.O_EXCL = O_EXCL;
+localFs.O_NOCTTY = O_NOCTTY;
+localFs.O_NOFOLLOW = O_NOFOLLOW;
+localFs.O_NONBLOCK = O_NONBLOCK;
+localFs.O_RDONLY = O_RDONLY;
+localFs.O_RDWR = O_RDWR;
+localFs.O_SYMLINK = O_SYMLINK;
+localFs.O_SYNC = O_SYNC;
+localFs.O_TRUNC = O_TRUNC;
+localFs.O_WRONLY = O_WRONLY;
+localFs.R_OK = R_OK;
+localFs.W_OK = W_OK;
+localFs.X_OK = X_OK;
+
+export default localFs;

package/lib/env/polyfills/fs/context/index.js

@@ -0,0 +1,3 @@
+import fsContext from './fs.context.js';
+
+export default { fsContext };

package/lib/env/polyfills/fs/fs.polyfills.js

@@ -0,0 +1,220 @@
+/* eslint-disable */
+import { join } from 'path-browserify';
+import promises from './promises.polyfills.js';
+
+const localFs = {};
+
+const BUILD_PATH_PREFIX = '.edge/storage';
+
+function open(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.open(path, ...args);
+}
+
+function openSync(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.openSync(path, ...args);
+}
+
+function close(...args) {
+  return FS_CONTEXT.close(...args);
+}
+
+function closeSync(...args) {
+  return FS_CONTEXT.closeSync(...args);
+}
+
+function stat(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.stat(path, ...args);
+}
+
+function statSync(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.statSync(path, ...args);
+}
+
+function lstat(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.lstat(path, ...args);
+}
+
+function lstatSync(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.lstatSync(path, ...args);
+}
+
+function readFile(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.readFile(path, ...args);
+}
+
+function readFileSync(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.readFileSync(path, ...args);
+}
+
+function readdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.readdir(path, ...args);
+}
+
+function readdirSync(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.readdirSync(path, ...args);
+}
+
+function mkdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.mkdir(path, ...args);
+}
+
+function rmdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.rmdir(path, ...args);
+}
+
+function copyFile(src, dest, ...args) {
+  src = `${BUILD_PATH_PREFIX}/${src}`;
+  dest = `${BUILD_PATH_PREFIX}/${dest}`;
+  return FS_CONTEXT.copyFile(src, dest, ...args);
+}
+
+function cp(src, dest, ...args) {
+  src = `${BUILD_PATH_PREFIX}/${src}`;
+  dest = `${BUILD_PATH_PREFIX}/${dest}`;
+  return FS_CONTEXT.cp(src, dest, ...args);
+}
+
+const constants = {
+  COPYFILE_EXCL: 1,
+  COPYFILE_FICLONE: 2,
+  COPYFILE_FICLONE_FORCE: 4,
+  F_OK: 0,
+  O_APPEND: 8,
+  O_CREAT: 512,
+  O_DIRECTORY: 1048576,
+  O_DSYNC: 4194304,
+  O_EXCL: 2048,
+  O_NOCTTY: 131072,
+  O_NOFOLLOW: 256,
+  O_NONBLOCK: 4,
+  O_RDONLY: 0,
+  O_RDWR: 2,
+  O_SYMLINK: 2097152,
+  O_SYNC: 128,
+  O_TRUNC: 1024,
+  O_WRONLY: 1,
+  R_OK: 4,
+  S_IRGRP: 32,
+  S_IROTH: 4,
+  S_IRUSR: 256,
+  S_IWGRP: 16,
+  S_IWOTH: 2,
+  S_IWUSR: 128,
+  S_IXGRP: 8,
+  S_IXOTH: 1,
+  S_IXUSR: 64,
+  UV_FS_COPYFILE_EXCL: 1,
+  UV_FS_COPYFILE_FICLONE: 2,
+  UV_FS_COPYFILE_FICLONE_FORCE: 4,
+  W_OK: 2,
+  X_OK: 1,
+};
+const F_OK = 0;
+const O_APPEND = 8;
+const O_CREAT = 512;
+const O_DIRECTORY = 1048576;
+const O_DSYNC = 4194304;
+const O_EXCL = 2048;
+const O_NOCTTY = 131072;
+const O_NOFOLLOW = 256;
+const O_NONBLOCK = 4;
+const O_RDONLY = 0;
+const O_RDWR = 2;
+const O_SYMLINK = 2097152;
+const O_SYNC = 128;
+const O_TRUNC = 1024;
+const O_WRONLY = 1;
+const R_OK = 4;
+const W_OK = 2;
+const X_OK = 1;
+
+export {
+  promises,
+  open,
+  openSync,
+  close,
+  closeSync,
+  stat,
+  statSync,
+  lstat,
+  lstatSync,
+  readFile,
+  readFileSync,
+  readdir,
+  readdirSync,
+  mkdir,
+  rmdir,
+  copyFile,
+  cp,
+  constants,
+  F_OK,
+  O_APPEND,
+  O_CREAT,
+  O_DIRECTORY,
+  O_DSYNC,
+  O_EXCL,
+  O_NOCTTY,
+  O_NOFOLLOW,
+  O_NONBLOCK,
+  O_RDONLY,
+  O_RDWR,
+  O_SYMLINK,
+  O_SYNC,
+  O_TRUNC,
+  O_WRONLY,
+  R_OK,
+  W_OK,
+  X_OK,
+};
+
+localFs.promises = promises;
+
+localFs.open = open;
+localFs.openSync = openSync;
+localFs.close = close;
+localFs.closeSync = closeSync;
+localFs.stat = stat;
+localFs.statSync = statSync;
+localFs.lstat = lstat;
+localFs.lstatSync = lstatSync;
+localFs.readFile = readFile;
+localFs.readFileSync = readFileSync;
+localFs.readdir = readdir;
+localFs.readdirSync = readdirSync;
+localFs.mkdir = mkdir;
+localFs.rmdir = rmdir;
+localFs.copyFile = copyFile;
+localFs.cp = cp;
+localFs.constants = constants;
+localFs.F_OK = F_OK;
+localFs.O_APPEND = O_APPEND;
+localFs.O_CREAT = O_CREAT;
+localFs.O_DIRECTORY = O_DIRECTORY;
+localFs.O_DSYNC = O_DSYNC;
+localFs.O_EXCL = O_EXCL;
+localFs.O_NOCTTY = O_NOCTTY;
+localFs.O_NOFOLLOW = O_NOFOLLOW;
+localFs.O_NONBLOCK = O_NONBLOCK;
+localFs.O_RDONLY = O_RDONLY;
+localFs.O_RDWR = O_RDWR;
+localFs.O_SYMLINK = O_SYMLINK;
+localFs.O_SYNC = O_SYNC;
+localFs.O_TRUNC = O_TRUNC;
+localFs.O_WRONLY = O_WRONLY;
+localFs.R_OK = R_OK;
+localFs.W_OK = W_OK;
+localFs.X_OK = X_OK;
+
+export default localFs;

package/lib/env/polyfills/fs/index.js

@@ -0,0 +1,8 @@
+/* eslint-disable import/prefer-default-export */
+/**
+ * We are not exporting the fs.polyfill.js from this structure due to the context definition in runtime.env.js.
+ * As we are proxying the Node.js fs lib, it is not possible to export the fs.polyfill.js file.
+ */
+import fsContext from './context/fs.context.js';
+
+export { fsContext };

package/lib/env/polyfills/fs/promises.polyfills.js

@@ -0,0 +1,115 @@
+/* eslint-disable */
+import { join } from 'path-browserify';
+
+const localFsPromises = {};
+
+const BUILD_PATH_PREFIX = '.edge/storage';
+
+async function open(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.open(path, ...args);
+}
+
+async function stat(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.stat(path, ...args);
+}
+
+async function lstat(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.lstat(path, ...args);
+}
+
+async function readFile(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.readFile(path, ...args);
+}
+
+async function readdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.readdir(path, ...args);
+}
+
+async function mkdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.mkdir(path, ...args);
+}
+
+async function rmdir(path, ...args) {
+  path = join(BUILD_PATH_PREFIX, path);
+  return FS_CONTEXT.promises.rmdir(path, ...args);
+}
+
+async function copyFile(src, dest, ...args) {
+  src = `${BUILD_PATH_PREFIX}/${src}`;
+  dest = `${BUILD_PATH_PREFIX}/${dest}`;
+  return FS_CONTEXT.promises.copyFile(src, dest, ...args);
+}
+
+async function cp(src, dest, ...args) {
+  src = `${BUILD_PATH_PREFIX}/${src}`;
+  dest = `${BUILD_PATH_PREFIX}/${dest}`;
+  return FS_CONTEXT.promises.cp(src, dest, ...args);
+}
+
+const constants = {
+  COPYFILE_EXCL: 1,
+  COPYFILE_FICLONE: 2,
+  COPYFILE_FICLONE_FORCE: 4,
+  F_OK: 0,
+  O_APPEND: 8,
+  O_CREAT: 512,
+  O_DIRECTORY: 1048576,
+  O_DSYNC: 4194304,
+  O_EXCL: 2048,
+  O_NOCTTY: 131072,
+  O_NOFOLLOW: 256,
+  O_NONBLOCK: 4,
+  O_RDONLY: 0,
+  O_RDWR: 2,
+  O_SYMLINK: 2097152,
+  O_SYNC: 128,
+  O_TRUNC: 1024,
+  O_WRONLY: 1,
+  R_OK: 4,
+  S_IRGRP: 32,
+  S_IROTH: 4,
+  S_IRUSR: 256,
+  S_IWGRP: 16,
+  S_IWOTH: 2,
+  S_IWUSR: 128,
+  S_IXGRP: 8,
+  S_IXOTH: 1,
+  S_IXUSR: 64,
+  UV_FS_COPYFILE_EXCL: 1,
+  UV_FS_COPYFILE_FICLONE: 2,
+  UV_FS_COPYFILE_FICLONE_FORCE: 4,
+  W_OK: 2,
+  X_OK: 1,
+};
+
+export {
+  open,
+  stat,
+  lstat,
+  readFile,
+  readdir,
+  mkdir,
+  rmdir,
+  copyFile,
+  cp,
+  constants,
+};
+
+localFsPromises.open = open;
+localFsPromises.stat = stat;
+localFsPromises.lstat = lstat;
+localFsPromises.readFile = readFile;
+localFsPromises.readdir = readdir;
+localFsPromises.mkdir = mkdir;
+localFsPromises.rmdir = rmdir;
+localFsPromises.copyFile = copyFile;
+localFsPromises.cp = cp;
+localFsPromises.constants = constants;
+
+export default localFsPromises;

package/lib/env/polyfills/index.js

@@ -4,6 +4,7 @@ import { AsyncHooksContext } from './async-hooks/index.js';
 import { StorageContext } from './azion/storage/index.js';
 import EnvVarsContext from './azion/env-vars/index.js';
 import NetworkListContext from './azion/network-list/index.js';
+import { fsContext } from './fs/index.js';
 
 export {
   fetchContext,
@@ -12,4 +13,5 @@ export {
   StorageContext,
   EnvVarsContext,
   NetworkListContext,
+  fsContext,
 };

package/lib/env/runtime.env.js

@@ -7,6 +7,7 @@ import {
   StorageContext,
   EnvVarsContext,
   NetworkListContext,
+  fsContext,
 } from './polyfills/index.js';
 import FirewallEventContext from './polyfills/azion/firewall-event/index.js';
 
@@ -83,6 +84,9 @@ function runtime(code, isFirewallEvent = false) {
     // Network List Context
     context.NETWORK_LIST_CONTEXT = NetworkListContext;
 
+    // FS Context
+    context.FS_CONTEXT = fsContext;
+
     return context;
   };
 

package/lib/presets/docusaurus/deliver/azion.config.js

@@ -0,0 +1,50 @@
+const AzionConfig = {
+  origin: [
+    {
+      name: 'origin-storage-default',
+      type: 'object_storage',
+    },
+  ],
+  rules: {
+    request: [
+      {
+        name: 'Set Storage Origin for All Requests',
+        match: '^\\/',
+        behavior: {
+          setOrigin: {
+            name: 'origin-storage-default',
+            type: 'object_storage',
+          },
+        },
+      },
+      {
+        name: 'Deliver Static Assets',
+        match:
+          '.(css|js|ttf|woff|woff2|pdf|svg|jpg|jpeg|gif|bmp|png|ico|mp4|json|xml|html)$',
+        behavior: {
+          setOrigin: {
+            name: 'origin-storage-default',
+            type: 'object_storage',
+          },
+          deliver: true,
+        },
+      },
+      {
+        name: 'Redirect to index.html',
+        match: '.*/$',
+        behavior: {
+          rewrite: '${uri}index.html',
+        },
+      },
+      {
+        name: 'Redirect to index.html for Subpaths',
+        match: '^(?!.*\\/$)(?![\\s\\S]*\\.[a-zA-Z0-9]+$).*',
+        behavior: {
+          rewrite: '${uri}/index.html',
+        },
+      },
+    ],
+  },
+};
+
+export default AzionConfig;

package/lib/presets/docusaurus/deliver/config.js

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

package/lib/presets/docusaurus/deliver/handler.js

@@ -0,0 +1,16 @@
+import { mountSSG, ErrorHTML } from '#edge';
+/**
+ * Handles the 'fetch' event.
+ * @param {any} event - The fetch event.
+ * @returns {Promise<Response>} The response for the request.
+ */
+async function handler(event) {
+  try {
+    const myApp = await mountSSG(event.request.url);
+    return myApp;
+  } catch (error) {
+    return ErrorHTML('404');
+  }
+}
+
+export default handler;

package/lib/presets/docusaurus/deliver/prebuild.js

@@ -0,0 +1,21 @@
+import { rm } from 'fs/promises';
+import { exec, getPackageManager, copyDirectory } from '#utils';
+
+const packageManager = await getPackageManager();
+
+/**
+ * Runs custom prebuild actions
+ */
+async function prebuild() {
+  const newOutDir = '.edge/storage';
+  const outDir = 'build';
+
+  await exec(`${packageManager} run build`, 'Docusaurus', true);
+
+  // move files to vulcan default path
+  copyDirectory(outDir, newOutDir);
+
+  rm(outDir, { recursive: true, force: true });
+}
+
+export default prebuild;

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

@@ -11,6 +11,7 @@ describe('getPresetsList utils', () => {
     const expectedOutput = [
       'angular',
       'astro',
+      'docusaurus',
       'eleventy',
       'emscripten',
       'gatsby',
@@ -75,6 +76,7 @@ describe('getPresetsList utils', () => {
     const expectedResult = [
       'Angular (Deliver)',
       'Astro (Deliver)',
+      'Docusaurus (Deliver)',
       'Eleventy (Deliver)',
       'Emscripten (Compute)',
       'Gatsby (Deliver)',
@@ -102,6 +104,7 @@ describe('getPresetsList utils', () => {
       'typescript',
       'angular',
       'astro',
+      'docusaurus',
       'eleventy',
       'emscripten',
       'hexo',
@@ -120,6 +123,7 @@ describe('getPresetsList utils', () => {
       ['Deliver'],
       ['Deliver'],
       ['Deliver'],
+      ['Deliver'],
       ['Compute'],
       ['Deliver'],
       ['Deliver'],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "edge-functions",
   "type": "module",
-  "version": "2.10.0",
+  "version": "2.11.0-stage.2",
   "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": {
@@ -24,7 +24,7 @@
     "e2e:start": "yarn submodule:update && tests/scripts/start-e2e-env.sh",
     "e2e:stop": "tests/scripts/stop-e2e-env.sh",
     "e2e:destroy": "tests/scripts/destroy-e2e-env.sh",
-    "test:e2e": "yarn e2e:start && jest --maxWorkers 1 tests/e2e/ --json --outputFile e2e_results.json && yarn e2e:reports && yarn e2e:stop; yarn task:reports",
+    "test:e2e": "yarn e2e:start && jest --maxWorkers 1 tests/e2e/ --json --outputFile e2e_results.json && yarn e2e:stop; yarn task:reports",
     "prepare": "husky install",
     "submodule:update": "git submodule update --init --recursive && git submodule foreach git pull origin main"
   },