Merge upstream develop

Author: github-actions[bot]

.nvmrc

@@ -1 +1 @@
-24.16.0
+24.17.0

README.md

@@ -30,9 +30,6 @@ The following commands will get you up and running:
 nvm install
 
 # Check you have the correct dependencies
-
-```
-
 apt-get install \
  protobuf-compiler \
  cmake \
@@ -41,8 +38,6 @@ apt-get install \
  libssl-dev \
  libsasl2-dev
 
-```
-
 # Add the WASM target to the rust toolchain
 rustup target add wasm32-unknown-unknown
 
@@ -67,6 +62,24 @@ If you're using Podman, ensure `docker compose` resolves to Compose v2.
 
 To run the server from source instead, see [`services/server/README.md`](services/server/README.md).
 
+### Clearing stale build caches
+
+Builds are cached by [Turbo](https://turborepo.com). The cache key does not
+track changes to installed dependencies, so after switching branches or updating
+deps (e.g. a `uniffi-bindgen-react-native` / `@ubjs/core` bump) `pnpm build` can
+restore a stale cached output and fail with mismatched generated bindings — for
+example a TypeScript error that two `Query` / `UniffiEnum` types "are unrelated".
+
+If that happens, clear the build cache and rebuild:
+
+```sh
+pnpm clean:cache
+pnpm build
+```
+
+If the generated uniffi bindings themselves are stale (not just their cache),
+also regenerate them with `pnpm ubrn:clean` followed by `pnpm build`.
+
 ## Project Structure
 
 ### Packages

package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "dev": "turbo run dev",
     "build": "turbo run build",
+    "clean:cache": "rm -rf .turbo node_modules/.cache/turbo",
     "format": "biome check",
     "format:fix": "biome check --write",
     "generate": "turbo run generate",

packages/js-core/package.json

@@ -35,7 +35,7 @@
     "@protobuf-ts/plugin": "^2.11.1",
     "ts-loader": "^9.5.4",
     "typescript": "catalog:",
-    "vitest": "^3.2.6",
+    "vitest": "^4.0.0",
     "webpack": "^5.100.1",
     "webpack-cli": "^7.0.0"
   }

packages/react-native/.nvmrc

@@ -1 +1 @@
-24.16.0
+24.17.0

packages/react-native/package.json

@@ -76,7 +76,7 @@
     "prettier": "^3.4.2",
     "react": "19.2.7",
     "react-native": "0.83.0",
-    "react-native-builder-bob": "^0.42.0",
+    "react-native-builder-bob": "^0.43.0",
     "typescript": "catalog:"
   },
   "peerDependencies": {