add event emitter support in docs

Author: lalalune

packages/docs/docusaurus.config.js

@@ -3,6 +3,9 @@ import dotenv from "dotenv";
 
 dotenv.config();
 
+// Import the EventEmitter polyfill
+require("./src/polyfills/eventEmitter.js");
+
 const config = {
 	title: "eliza",
 	tagline: "Flexible, scalable AI agents for everyone",
@@ -15,7 +18,16 @@ const config = {
 	trailingSlash: true,
 	onBrokenLinks: "ignore",
 	onBrokenMarkdownLinks: "warn",
-
+	customFields: {
+		// This is a workaround for the EventEmitter issue in the docs build
+		EventEmitter: class EventEmitter {
+			constructor() {}
+			on() {}
+			once() {}
+			emit() {}
+			removeListener() {}
+		},
+	},
 	i18n: {
 		defaultLocale: "en",
 		locales: ["en"],
@@ -24,6 +36,7 @@ const config = {
 		mermaid: true,
 	},
 	themes: ["@docusaurus/theme-mermaid"],
+	clientModules: [require.resolve("./src/polyfills/eventEmitter.js")],
 	plugins: [
 		[
 			"@docusaurus/plugin-content-docs",
@@ -88,19 +101,11 @@ const config = {
 				readme: "none",
 				commentStyle: "all",
 				preserveAnchorCasing: false,
-				hideBreadcrumbs: false,
-				publicPath: "/api/",
-				treatWarningsAsErrors: false,
-				treatValidationWarningsAsErrors: false,
-				searchInComments: true,
-				disableGit: false,
-				validation: {
-					invalidLink: true,
-					notDocumented: false,
-				},
-				navigationLinks: {
-					GitHub: "https://github.com/elizaos/eliza",
-					Documentation: "/docs/intro",
+				externalSymbolLinkMappings: {
+					"node:events": {
+						EventEmitter:
+							"https://nodejs.org/api/events.html#class-eventemitter",
+					},
 				},
 			},
 		],
@@ -113,7 +118,6 @@ const config = {
 				routeBasePath: "api",
 			},
 		],
-		require.resolve("./plugin/event-emitter-polyfill"),
 	],
 	presets: [
 		[

packages/docs/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elizaos/docs",
-	"version": "1.0.0-alpha.1",
+	"version": "1.0.0-alpha.0",
 	"private": true,
 	"packageManager": "bun@9.4.0",
 	"scripts": {
@@ -21,30 +21,23 @@
 		"@docusaurus/plugin-content-docs": "3.7.0",
 		"@docusaurus/plugin-ideal-image": "3.7.0",
 		"@docusaurus/preset-classic": "3.7.0",
-		"@docusaurus/theme-common": "3.7.0",
 		"@docusaurus/theme-mermaid": "3.7.0",
+		"@docusaurus/theme-common": "3.7.0",
 		"@mdx-js/react": "3.0.1",
 		"clsx": "2.1.1",
 		"docusaurus-lunr-search": "3.5.0",
-		"dotenv": "^16.4.7",
 		"lunr": "2.3.9",
+		"dotenv": "^16.4.7",
 		"prism-react-renderer": "2.3.1",
 		"react": "^19.0.0",
 		"react-dom": "^19.0.0"
 	},
 	"devDependencies": {
 		"@docusaurus/module-type-aliases": "3.7.0",
-		"@docusaurus/remark-plugin-npm2yarn": "^3.7.0",
 		"@docusaurus/types": "3.7.0",
-		"@types/node": "^22.13.9",
-		"assert": "^2.1.0",
-		"docusaurus-plugin-typedoc": "1.2.2",
-		"events": "^3.3.0",
-		"path-browserify": "^1.0.1",
-		"stream-browserify": "^3.0.0",
+		"docusaurus-plugin-typedoc": "1.0.5",
 		"typedoc": "0.26.11",
-		"typedoc-plugin-markdown": "4.2.10",
-		"util": "^0.12.5"
+		"typedoc-plugin-markdown": "4.2.10"
 	},
 	"browserslist": {
 		"production": [">0.5%", "not dead", "not op_mini all"],

packages/docs/src/polyfills/eventEmitter.js

@@ -0,0 +1,47 @@
+/**
+ * Simple EventEmitter polyfill for documentation
+ */
+if (typeof global !== "undefined" && !global.EventEmitter) {
+	global.EventEmitter = class EventEmitter {
+		constructor() {
+			this.events = {};
+		}
+
+		on(event, listener) {
+			if (!this.events[event]) {
+				this.events[event] = [];
+			}
+			this.events[event].push(listener);
+			return this;
+		}
+
+		once(event, listener) {
+			const onceWrapper = (...args) => {
+				listener(...args);
+				this.removeListener(event, onceWrapper);
+			};
+			return this.on(event, onceWrapper);
+		}
+
+		emit(event, ...args) {
+			if (!this.events[event]) {
+				return false;
+			}
+			this.events[event].forEach((listener) => listener(...args));
+			return true;
+		}
+
+		removeListener(event, listener) {
+			if (!this.events[event]) {
+				return this;
+			}
+			this.events[event] = this.events[event].filter((l) => l !== listener);
+			return this;
+		}
+	};
+}
+
+// Also add to window for client-side rendering
+if (typeof window !== "undefined" && !window.EventEmitter) {
+	window.EventEmitter = global.EventEmitter;
+}