feat: update configuration files to use path resolution and add node polyfills

Author: hotlong

apps/docs/source.config.ts

@@ -1,8 +1,12 @@
 import { defineDocs, defineConfig, frontmatterSchema } from 'fumadocs-mdx/config';
 import { z } from 'zod';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
 
 export const docs = defineDocs({
-  dir: '../../content/docs',
+  dir: path.resolve(currentDir, '../../content/docs'),
 });
 
 const blogSchema = frontmatterSchema.extend({
@@ -12,7 +16,7 @@ const blogSchema = frontmatterSchema.extend({
 });
 
 export const blog = defineDocs({
-  dir: '../../content/blog',
+  dir: path.resolve(currentDir, '../../content/blog'),
   docs: {
     schema: blogSchema,
   },

examples/app-react-crud/mocks/empty.ts

@@ -0,0 +1,3 @@
+export default {};
+export class FilesystemLoader {}
+export class NodeMetadataManager {}

examples/app-react-crud/mocks/node-polyfills.ts

@@ -0,0 +1,79 @@
+export class EventEmitter {
+  on() { return this; }
+  off() { return this; }
+  emit() { return true; }
+  once() { return this; }
+  addListener() { return this; }
+  removeListener() { return this; }
+  removeAllListeners() { return this; }
+}
+export default { EventEmitter };
+
+export class Stream extends EventEmitter {
+    pipe() { return this; }
+}
+export class Readable extends Stream {}
+export class Writable extends Stream {}
+export class Transform extends Stream {}
+
+export class StringDecoder {
+  write() { return ''; }
+  end() { return ''; }
+}
+
+export const promises = {
+  readFile: async () => '',
+  writeFile: async () => {},
+  stat: async () => ({ isDirectory: () => false, isFile: () => false }),
+  mkdir: async () => {},
+  rm: async () => {},
+};
+
+export const readFileSync = () => '';
+export const writeFileSync = () => {};
+export const statSync = () => ({ isDirectory: () => false, isFile: () => false, isSymbolicLink: () => false });
+export const lstatSync = () => ({ isDirectory: () => false, isFile: () => false, isSymbolicLink: () => false });
+export const existsSync = () => false;
+export const join = (...args) => args.join('/');
+export const resolve = (...args) => args.join('/');
+export const dirname = (path) => path;
+export const basename = (path) => path;
+export const extname = (path) => '';
+export const sep = '/';
+export const relative = () => '';
+
+export const posix = {};
+export const win32 = {};
+
+export const fileURLToPath = () => '';
+export const pathToFileURL = () => '';
+
+export const readdir = () => {};
+export const readdirSync = () => [];
+export const readlink = () => {};
+export const readlinkSync = () => '';
+export const realpath = () => {};
+export const realpathSync = () => '';
+realpathSync.native = () => '';
+
+export const constants = {};
+export const lstat = () => {};
+export const stat = () => {};
+export const access = () => {};
+export const accessSync = () => {};
+export const mkdir = () => {};
+export const mkdirSync = () => {};
+export const rmdir = () => {};
+export const rmdirSync = () => {};
+export const unlink = () => {};
+export const unlinkSync = () => {};
+export const copyFile = () => {};
+export const copyFileSync = () => {};
+export const createReadStream = () => new Readable();
+export const createWriteStream = () => new Writable();
+export const watch = () => new EventEmitter();
+
+export const readFile = async () => '';
+export const writeFile = async () => {};
+export const rename = async () => {};
+export const createHash = () => ({ update: () => ({ digest: () => '' }) });

examples/app-react-crud/vite.config.ts

@@ -1,8 +1,33 @@
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
+import path from 'path';
 
 // https://vitejs.dev/config/
 export default defineConfig({
+  resolve: {
+    alias: {
+      'node:fs/promises': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:fs': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:events': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:stream': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:string_decoder': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:path': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:url': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:util': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:os': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'node:crypto': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'events': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'stream': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'string_decoder': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'path': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'fs/promises': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'fs': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'util': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'os': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'crypto': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+      'url': path.resolve(__dirname, './mocks/node-polyfills.ts'),
+    }
+  },
   plugins: [react()],
   server: {
     port: 3000,
@@ -21,6 +46,7 @@ export default defineConfig({
   build: {
     commonjsOptions: {
       include: [/node_modules/, /packages/],
+      exclude: [/\.node$/, /rollup/, /fsevents/],
       transformMixedEsModules: true
     },
     rollupOptions: {

packages/runtime/src/http-dispatcher.test.ts

@@ -57,7 +57,7 @@ describe('HttpDispatcher', () => {
 
         it('should fallback to broker call if protocol is missing saveMetaItem', async () => {
              // Mock protocol without saveMetaItem
-            kernel.context.getService = () => ({}); 
+            (kernel as any).context.getService = () => ({}); 
             // Mock broker success
             mockBroker.call.mockResolvedValue({ success: true, fromBroker: true });