Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(desktop): pin rpc-websockets to uuid 11 so the app no longer crashes at launch with ERR_REQUIRE_ESM

nirholasc92b56c30c3d
diff --git a/apps/desktop/package-lock.json b/apps/desktop/package-lock.json
index 138fa9dfe..328100dbd 100644
--- a/apps/desktop/package-lock.json
+++ b/apps/desktop/package-lock.json
@@ -5108,16 +5108,16 @@
}
},
"node_modules/rpc-websockets/node_modules/uuid": {
- "version": "14.0.3",
- "resolved": "https://registry.npmjs.org/uuid/-/uuid-14.0.3.tgz",
- "integrity": "sha512-Sc5u1VVln93y1Xnz4R+CunOZc7R9LUcTmhj7Rc7Eg3HVcf7rVn2FOoa812fe0W8p3jD7xeoGSYbfqCGGH2B6xw==",
+ "version": "11.1.1",
+ "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.1.tgz",
+ "integrity": "sha512-vIYxrBCC/N/K+Js3qSN88go7kIfNPssr/hHCesKCQNAjmgvYS2oqr69kIufEG+O4+PfezOH4EbIeHCfFov8ZgQ==",
"funding": [
"https://github.com/sponsors/broofa",
"https://github.com/sponsors/ctavan"
],
"license": "MIT",
"bin": {
- "uuid": "dist-node/bin/uuid"
+ "uuid": "dist/esm/bin/uuid"
}
},
"node_modules/rpc-websockets/node_modules/ws": {
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index 166cf66f4..370a3fac5 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -36,6 +36,11 @@
"marked": "^18.0.13",
"smol-toml": "^1.8.0"
},
+ "overrides": {
+ "rpc-websockets": {
+ "uuid": "^11.1.0"
+ }
+ },
"devDependencies": {
"electron": "^33.2.0",
"electron-builder": "^25.1.8"
diff --git a/tests/desktop-deps.test.js b/tests/desktop-deps.test.js
new file mode 100644
index 000000000..c52515b38
--- /dev/null
+++ b/tests/desktop-deps.test.js
@@ -0,0 +1,18 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+
+// The desktop app runs on Electron's bundled Node, which cannot require() an
+// ES-module-only package. @solana/web3.js pulls in rpc-websockets, which
+// require()s uuid, and uuid 12 and up is ESM-only. With uuid 14 resolved the
+// app dies at launch ("ERR_REQUIRE_ESM") before any window opens.
+describe('desktop app dependency tree', () => {
+ const lock = JSON.parse(readFileSync(new URL('../apps/desktop/package-lock.json', import.meta.url), 'utf8'));
+
+ it('resolves a CommonJS-loadable uuid everywhere', () => {
+ const uuids = Object.entries(lock.packages).filter(([key]) => key === 'node_modules/uuid' || key.endsWith('/node_modules/uuid'));
+ expect(uuids.length).toBeGreaterThan(0);
+ for (const [key, pkg] of uuids) {
+ expect(Number(pkg.version.split('.')[0]), `${key}@${pkg.version}`).toBeLessThanOrEqual(11);
+ }
+ });
+});