Merge pull request #2776 from garden-co/changeset-release/main

Version Packages
2025-08-20 13:25:30 +02:00 · 2025-08-20 10:59:08 +00:00 · 2025-08-20 12:55:18 +02:00 · 2025-08-20 12:54:16 +02:00 · 2025-08-20 12:50:38 +02:00 · 2025-08-20 11:41:31 +01:00
62 changed files with 846 additions and 113 deletions
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -0,0 +1,8 @@
 ./packages @garden-co/framework
 ./tests @garden-co/framework
 ./packages/quint-ui @garden-co/ui
 ./homepage @garden-co/ui
 ./homepage/homepage/content/docs @garden-co/docs
 ./starters @garden-co/docs
 ./examples @garden-co/docs @garden-co/ui
--- a/examples/chat-svelte/CHANGELOG.md
+++ b/examples/chat-svelte/CHANGELOG.md
@@ -1,5 +1,27 @@
 # passkey-svelte
 ## 0.0.122
 ### Patch Changes
 - Updated dependencies [52ea0c7]
  - jazz-tools@0.17.9
 ## 0.0.121
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
 ## 0.0.120
 ### Patch Changes
 - jazz-tools@0.17.7
 ## 0.0.119
 ### Patch Changes
--- a/examples/chat-svelte/package.json
+++ b/examples/chat-svelte/package.json
@@ -1,6 +1,6 @@
 {
  "name": "chat-svelte",
-  "version": "0.0.119",
+  "version": "0.0.122",
  "type": "module",
  "private": true,
  "scripts": {
--- a/examples/clerk/index.html
+++ b/examples/clerk/index.html
@@ -9,8 +9,10 @@
 </head>
 <body>
-  <div id="root"></div>
+  <div id="root">
    <p>Loading...</p>
  </div>
  <script type="module" src="/src/main.tsx"></script>
 </body>
-</html>
+</html>
--- a/examples/clerk/src/main.tsx
+++ b/examples/clerk/src/main.tsx
@@ -24,6 +24,7 @@ function JazzProvider({ children }: { children: ReactNode }) {
      sync={{
        peer: `wss://cloud.jazz.tools/?key=${apiKey}`,
      }}
      fallback={<p>Loading...</p>}
    >
      {children}
    </JazzReactProviderWithClerk>
--- a/homepage/homepage/content/docs/docNavigationItems.js
+++ b/homepage/homepage/content/docs/docNavigationItems.js
@@ -25,6 +25,11 @@ export const docNavigationItems = [
        excludeFromNavigation: true,
      },
      { name: "FAQs", href: "/docs/faq", done: 100 },
      {
        name: "Troubleshooting",
        href: "/docs/troubleshooting",
        done: 100,
      },
    ],
  },
  {
--- a/homepage/homepage/content/docs/groups/intro.mdx
+++ b/homepage/homepage/content/docs/groups/intro.mdx
@@ -49,18 +49,20 @@ if (bob) {
 ```
 </CodeGroup>
-**Note:** if the account ID is of type `string`, because it comes from a URL parameter or something similar, you need to cast it to `ID<Account>` first:
+**Note:** 
 - Both `Account.load(id)` and `co.account().load(id)` do the same thing — they load an account from its ID.
 <CodeGroup>
 ```tsx twoslash
 const bobsID = "co_z123";
-
+import { Group } from "jazz-tools";
 const group = Group.create();
 // ---cut---
-import { co, Group } from "jazz-tools";
+import { ID, Account, co } from "jazz-tools";
-const bob = await co.account().load(bobsID);
+const bob = await Account.load(bobsID);
 // Or: const bob = await co.account().load(bobsID);
 if (bob) {
  group.addMember(bob, "writer");
--- a/homepage/homepage/content/docs/index.mdx
+++ b/homepage/homepage/content/docs/index.mdx
@@ -25,7 +25,10 @@ You can use [`create-jazz-app`](/docs/tools/create-jazz-app) to create a new Jaz
  ```
 </CodeGroup>
-<Alert variant="info" className="mt-4 flex gap-2 items-center">Requires at least Node.js v20.</Alert>
+<Alert variant="info" className="mt-4 flex gap-2 items-center">
 Requires at least Node.js v20.
 See our [Troubleshooting Guide](https://jazz.tools/docs/troubleshooting) for quick fixes.
 </Alert>
 {/* <ContentByFramework framework="react">
 Or you can follow this [React step-by-step guide](/docs/react/guide) where we walk you through building an issue tracker app.
--- a/homepage/homepage/content/docs/project-setup/react-native-expo.mdx
+++ b/homepage/homepage/content/docs/project-setup/react-native-expo.mdx
@@ -53,6 +53,7 @@ npm i -S jazz-tools
 <Alert variant="info" className="mt-4" title="Note">
  - Requires at least Node.js v20. 
  - Hermes has added support for `atob` and `btoa` in React Native 0.74. If you are using earlier versions, you may also need to polyfill `atob` and `btoa` in your `package.json`. Packages to try include `text-encoding` and `base-64`, and you can drop `@bacons/text-decoder`.
   See our [Troubleshooting Guide](https://jazz.tools/docs/troubleshooting) for quick fixes.
 </Alert>
 #### Fix incompatible dependencies
--- a/homepage/homepage/content/docs/project-setup/react-native.mdx
+++ b/homepage/homepage/content/docs/project-setup/react-native.mdx
@@ -51,7 +51,6 @@ npm i -S jazz-tools
 </CodeGroup>
 <Alert variant="info" className="mt-4" title="Note">
  - Requires at least Node.js v20. 
  - Hermes has added support for `atob` and `btoa` in React Native 0.74. If you are using earlier versions, you may also need to polyfill `atob` and `btoa` in your `package.json`. Packages to try include `text-encoding` and `base-64`, and you can drop `@bacons/text-decoder`.
 </Alert>
--- a/homepage/homepage/content/docs/project-setup/react.mdx
+++ b/homepage/homepage/content/docs/project-setup/react.mdx
@@ -27,8 +27,6 @@ pnpm install jazz-tools
 ```
 </CodeGroup>
 <Alert variant="info" className="mt-4 flex gap-2 items-center">Requires at least Node.js v20.</Alert>
 ## Write your schema
 Define your data schema using [CoValues](/docs/schemas/covalues) from `jazz-tools`.
--- a/homepage/homepage/content/docs/project-setup/svelte.mdx
+++ b/homepage/homepage/content/docs/project-setup/svelte.mdx
@@ -19,8 +19,6 @@ pnpm install jazz-tools
 ```
 </CodeGroup>
 <Alert variant="info" className="mt-4 flex gap-2 items-center">Requires at least Node.js v20.</Alert>
 ## Write your schema
 See the [schema docs](/docs/schemas/covalues) for more information.
--- a/homepage/homepage/content/docs/sync-and-storage.mdx
+++ b/homepage/homepage/content/docs/sync-and-storage.mdx
@@ -1,4 +1,5 @@
 import { ContentByFramework, CodeGroup } from '@/components/forMdx'
 import { Alert } from "@garden-co/design-system/src/components/atoms/Alert";
 export const metadata = { 
  description: "Learn how to sync and persist your data using Jazz Cloud, or run your own sync server."
@@ -44,8 +45,14 @@ And then use `ws://localhost:4200` as the sync server URL.
 You can also run this simple sync server behind a proxy that supports WebSockets, for example to provide TLS.
 In this case, provide the WebSocket endpoint your proxy exposes as the sync server URL.
 <Alert variant="info" className="mt-4 flex gap-2 items-center">
 Requires at least Node.js v20.
 See our [Troubleshooting Guide](https://jazz.tools/docs/troubleshooting) for quick fixes.
 </Alert>
 ### Command line options:
 - `--host` / `-h` - the host to run the sync server on. Defaults to 127.0.0.1.
 - `--port` / `-p` - the port to run the sync server on. Defaults to 4200.
 - `--in-memory` - keep CoValues in-memory only and do sync only, no persistence. Persistence is enabled by default.
 - `--db` - the path to the file where to store the data (SQLite). Defaults to `sync-db/storage.db`.
--- a/homepage/homepage/content/docs/troubleshooting.mdx
+++ b/homepage/homepage/content/docs/troubleshooting.mdx
@@ -0,0 +1,133 @@
 import { ContentByFramework, CodeGroup } from '@/components/forMdx'
 import { Alert } from "@garden-co/design-system/src/components/atoms/Alert";
 export const metadata = {
  title: "Setup troubleshooting",
  description: "A few reported setup hiccups and how to fix them."
 };
 # Setup troubleshooting
 A few reported setup hiccups and how to fix them.
 ---
 ## Node.js version requirements
 Jazz requires **Node.js v20 or later** due to native module dependencies.  
 Check your version:
 <CodeGroup>
 ```sh
 node -v
 ```
 </CodeGroup>
 If you’re on Node 18 or earlier, upgrade via nvm:
 <CodeGroup>
 ```sh
 nvm install 20
 nvm use 20
 ```
 </CodeGroup>
 ---
 ## npx jazz-run: command not found
 If, when running:
 <CodeGroup>
 ```sh
 npx jazz-run sync
 ```
 </CodeGroup>
 you encounter:
 <CodeGroup>
 ```sh
 sh: jazz-run: command not found
 ```
 </CodeGroup>
 This is often due to an npx cache quirk. (For most apps using Jazz)
 1. Clear your npx cache:
 <CodeGroup>
 ```sh
 npx clear-npx-cache
 ```
 </CodeGroup>
 2. Rerun the command:
 <CodeGroup>
 ```sh
 npx jazz-run sync
 ```
 </CodeGroup>
 ---
 ### Node 18 workaround (rebuilding the native module)
 If you can’t upgrade to Node 20+, you can rebuild the native `better-sqlite3` module for your architecture.
 1. Install `jazz-run` locally in your project:
 <CodeGroup>
 ```sh
 pnpm add -D jazz-run
 ```
 </CodeGroup>
 2. Find the installed version of better-sqlite3 inside node_modules.
 It should look like this:
 <CodeGroup>
 ```sh
 ./node_modules/.pnpm/better-sqlite3{version}/node_modules/better-sqlite3
 ```
 </CodeGroup>
 Replace `{version}` with your installed version and run:
 <CodeGroup>
 ```sh
 # Navigate to the installed module and rebuild
 pushd ./node_modules/.pnpm/better-sqlite3{version}/node_modules/better-sqlite3
 && pnpm install
 && popd
 ```
 </CodeGroup>
 If you get ModuleNotFoundError: No module named 'distutils':
 Linux:
 <CodeGroup>
 ```sh
 pip install --upgrade setuptools
 ```
 </CodeGroup>
 macOS:
 <CodeGroup>
 ```sh
 brew install python-setuptools
 ```
 </CodeGroup>
 <p><i>Workaround originally shared by @aheissenberger on Jun 24, 2025.</i></p>
 ---
 ### Still having trouble?
 If none of the above fixes work:
 Make sure dependencies installed without errors (`pnpm install`).
 Double-check your `node -v` output matches the required version.
 Open an issue on GitHub with:
 - Your OS and version
 - Node.js version
 - Steps you ran and full error output
 We're always happy to help! If you're stuck, reachout via [Discord](https://discord.gg/utDMjHYg42)
--- a/homepage/homepage/content/navigation-items.ts
+++ b/homepage/homepage/content/navigation-items.ts
@@ -26,3 +26,4 @@ export const navigationItems: NavItemProps[] = [
    title: "Status",
  },
 ];
--- a/packages/cojson-storage-indexeddb/CHANGELOG.md
+++ b/packages/cojson-storage-indexeddb/CHANGELOG.md
@@ -1,5 +1,24 @@
 # cojson-storage-indexeddb
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [7586c3b]
  - cojson@0.17.9
 ## 0.17.8
 ### Patch Changes
 - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/cojson-storage-indexeddb/package.json
+++ b/packages/cojson-storage-indexeddb/package.json
@@ -1,6 +1,6 @@
 {
  "name": "cojson-storage-indexeddb",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "main": "dist/index.js",
  "type": "module",
  "types": "dist/index.d.ts",
--- a/packages/cojson-storage-sqlite/CHANGELOG.md
+++ b/packages/cojson-storage-sqlite/CHANGELOG.md
@@ -1,5 +1,24 @@
 # cojson-storage-sqlite
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [7586c3b]
  - cojson@0.17.9
 ## 0.17.8
 ### Patch Changes
 - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/cojson-storage-sqlite/package.json
+++ b/packages/cojson-storage-sqlite/package.json
@@ -1,7 +1,7 @@
 {
  "name": "cojson-storage-sqlite",
  "type": "module",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "license": "MIT",
--- a/packages/cojson-transport-ws/CHANGELOG.md
+++ b/packages/cojson-transport-ws/CHANGELOG.md
@@ -1,5 +1,24 @@
 # cojson-transport-nodejs-ws
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [7586c3b]
  - cojson@0.17.9
 ## 0.17.8
 ### Patch Changes
 - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/cojson-transport-ws/package.json
+++ b/packages/cojson-transport-ws/package.json
@@ -1,7 +1,7 @@
 {
  "name": "cojson-transport-ws",
  "type": "module",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "license": "MIT",
--- a/packages/cojson/CHANGELOG.md
+++ b/packages/cojson/CHANGELOG.md
@@ -1,5 +1,15 @@
 # cojson
 ## 0.17.9
 ### Patch Changes
 - 7586c3b: Adds disableTransactionVerification() method to SyncManager
 ## 0.17.8
 ## 0.17.7
 ## 0.17.6
 ## 0.17.5
--- a/packages/cojson/package.json
+++ b/packages/cojson/package.json
@@ -25,7 +25,7 @@
  },
  "type": "module",
  "license": "MIT",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "devDependencies": {
    "@opentelemetry/sdk-metrics": "^2.0.0",
    "libsql": "^0.5.13",
--- a/packages/cojson/src/sync.ts
+++ b/packages/cojson/src/sync.ts
@@ -132,6 +132,11 @@ export class SyncManager {
  peers: { [key: PeerID]: PeerState } = {};
  local: LocalNode;
  // When true, transactions will not be verified.
  // This is useful when syncing only for storage purposes, with the expectation that
  // the transactions have already been verified by the [trusted] peer that sent them.
  private skipVerify: boolean = false;
  peersCounter = metrics.getMeter("cojson").createUpDownCounter("jazz.peers", {
    description: "Amount of connected peers",
    valueType: ValueType.INT,
@@ -154,6 +159,10 @@ export class SyncManager {
  syncState: SyncStateManager;
  disableTransactionVerification() {
    this.skipVerify = true;
  }
  peersInPriorityOrder(): PeerState[] {
    return Object.values(this.peers).sort((a, b) => {
      const aPriority = a.priority || 0;
@@ -637,6 +646,7 @@ export class SyncManager {
        undefined,
        newContentForSession.lastSignature,
        "immediate",
        this.skipVerify,
      );
      if (result.isErr()) {
--- a/packages/cojson/src/tests/sync.test.ts
+++ b/packages/cojson/src/tests/sync.test.ts
@@ -20,11 +20,13 @@ import {
  createTestNode,
  loadCoValueOrFail,
  nodeWithRandomAgentAndSessionID,
  randomAgentAndSessionID,
  setupTestAccount,
  setupTestNode,
  tearDownTestMetricReader,
  waitFor,
 } from "./testUtils.js";
 import { stableStringify } from "../jsonStringify.js";
 // We want to simulate a real world communication that happens asynchronously
 TEST_NODE_CONFIG.withAsyncPeers = true;
@@ -160,6 +162,36 @@ test("should delete the peer state when the peer closes if persistent is false",
  expect(syncManager.peers[peer.id]).toBeUndefined();
 });
 test("should not verify transactions when SyncManager has verification disabled", async () => {
  jazzCloud.node.syncManager.disableTransactionVerification();
  const [agent] = randomAgentAndSessionID();
  const client = await setupTestAccount({ connected: true });
  const group = client.node.createGroup();
  const map = group.createMap();
  map.core.tryAddTransactions(
    client.node.currentSessionID,
    [
      {
        privacy: "trusting",
        changes: stableStringify([{ op: "set", key: "hello", value: "world" }]),
        madeAt: Date.now(),
      },
    ],
    undefined,
    Crypto.sign(agent.currentSignerSecret(), "hash_z12345678"),
    "immediate",
    true,
  );
  await map.core.waitForSync();
  const loadedMap = await loadCoValueOrFail(jazzCloud.node, map.id);
  expect(loadedMap.get("hello")).toEqual("world");
 });
 describe("sync - extra tests", () => {
  test("Node handles disconnection and reconnection of a peer gracefully", async () => {
    // Create two nodes
--- a/packages/community-jazz-vue/CHANGELOG.md
+++ b/packages/community-jazz-vue/CHANGELOG.md
@@ -1,5 +1,31 @@
 # jazz-react
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [52ea0c7]
 - Updated dependencies [7586c3b]
  - jazz-tools@0.17.9
  - cojson@0.17.9
 ## 0.17.8
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
  - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 - jazz-tools@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/community-jazz-vue/package.json
+++ b/packages/community-jazz-vue/package.json
@@ -1,6 +1,6 @@
 {
  "name": "community-jazz-vue",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "type": "module",
  "main": "dist/index.js",
  "types": "src/index.ts",
--- a/packages/jazz-auth-betterauth/CHANGELOG.md
+++ b/packages/jazz-auth-betterauth/CHANGELOG.md
@@ -1,5 +1,34 @@
 # jazz-auth-betterauth
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [52ea0c7]
 - Updated dependencies [7586c3b]
  - jazz-tools@0.17.9
  - cojson@0.17.9
  - jazz-betterauth-client-plugin@0.17.9
 ## 0.17.8
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
  - jazz-betterauth-client-plugin@0.17.8
  - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 - jazz-betterauth-client-plugin@0.17.7
 - jazz-tools@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-auth-betterauth/package.json
+++ b/packages/jazz-auth-betterauth/package.json
@@ -1,6 +1,6 @@
 {
  "name": "jazz-auth-betterauth",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "type": "module",
  "main": "dist/index.js",
  "types": "src/index.ts",
--- a/packages/jazz-betterauth-client-plugin/CHANGELOG.md
+++ b/packages/jazz-betterauth-client-plugin/CHANGELOG.md
@@ -1,5 +1,23 @@
 # jazz-betterauth-client-plugin
 ## 0.17.9
 ### Patch Changes
 - jazz-betterauth-server-plugin@0.17.9
 ## 0.17.8
 ### Patch Changes
 - jazz-betterauth-server-plugin@0.17.8
 ## 0.17.7
 ### Patch Changes
 - jazz-betterauth-server-plugin@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-betterauth-client-plugin/package.json
+++ b/packages/jazz-betterauth-client-plugin/package.json
@@ -1,6 +1,6 @@
 {
  "name": "jazz-betterauth-client-plugin",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "type": "module",
  "main": "dist/index.js",
  "types": "src/index.ts",
--- a/packages/jazz-betterauth-server-plugin/CHANGELOG.md
+++ b/packages/jazz-betterauth-server-plugin/CHANGELOG.md
@@ -1,5 +1,31 @@
 # jazz-betterauth-server-plugin
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [52ea0c7]
 - Updated dependencies [7586c3b]
  - jazz-tools@0.17.9
  - cojson@0.17.9
 ## 0.17.8
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
  - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 - jazz-tools@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-betterauth-server-plugin/package.json
+++ b/packages/jazz-betterauth-server-plugin/package.json
@@ -1,6 +1,6 @@
 {
  "name": "jazz-betterauth-server-plugin",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "type": "module",
  "main": "dist/index.js",
  "types": "src/index.ts",
--- a/packages/jazz-react-auth-betterauth/CHANGELOG.md
+++ b/packages/jazz-react-auth-betterauth/CHANGELOG.md
@@ -1,5 +1,37 @@
 # jazz-react-auth-betterauth
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [52ea0c7]
 - Updated dependencies [7586c3b]
  - jazz-tools@0.17.9
  - cojson@0.17.9
  - jazz-auth-betterauth@0.17.9
  - jazz-betterauth-client-plugin@0.17.9
 ## 0.17.8
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
  - jazz-auth-betterauth@0.17.8
  - jazz-betterauth-client-plugin@0.17.8
  - cojson@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 - jazz-auth-betterauth@0.17.7
 - jazz-betterauth-client-plugin@0.17.7
 - jazz-tools@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-react-auth-betterauth/package.json
+++ b/packages/jazz-react-auth-betterauth/package.json
@@ -1,6 +1,6 @@
 {
  "name": "jazz-react-auth-betterauth",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "type": "module",
  "main": "dist/index.js",
  "types": "src/index.tsx",
--- a/packages/jazz-run/CHANGELOG.md
+++ b/packages/jazz-run/CHANGELOG.md
@@ -1,5 +1,38 @@
 # jazz-run
 ## 0.17.9
 ### Patch Changes
 - Updated dependencies [52ea0c7]
 - Updated dependencies [7586c3b]
  - jazz-tools@0.17.9
  - cojson@0.17.9
  - cojson-storage-sqlite@0.17.9
  - cojson-transport-ws@0.17.9
 ## 0.17.8
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
  - cojson@0.17.8
  - cojson-storage-sqlite@0.17.8
  - cojson-transport-ws@0.17.8
 ## 0.17.7
 ### Patch Changes
 - feaa69e: Add host option to the jazz-run sync command
  - cojson@0.17.7
  - cojson-storage-sqlite@0.17.7
  - cojson-transport-ws@0.17.7
  - jazz-tools@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-run/package.json
+++ b/packages/jazz-run/package.json
@@ -3,7 +3,7 @@
  "bin": "./dist/index.js",
  "type": "module",
  "license": "MIT",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "exports": {
    "./startSyncServer": {
      "types": "./dist/startSyncServer.d.ts",
@@ -28,11 +28,11 @@
    "@effect/printer-ansi": "^0.34.5",
    "@effect/schema": "^0.71.1",
    "@effect/typeclass": "^0.25.5",
-    "cojson": "workspace:0.17.6",
+    "cojson": "workspace:0.17.9",
-    "cojson-storage-sqlite": "workspace:0.17.6",
+    "cojson-storage-sqlite": "workspace:0.17.9",
-    "cojson-transport-ws": "workspace:0.17.6",
+    "cojson-transport-ws": "workspace:0.17.9",
    "effect": "^3.6.5",
-    "jazz-tools": "workspace:0.17.6",
+    "jazz-tools": "workspace:0.17.9",
    "ws": "^8.14.2"
  },
  "devDependencies": {
--- a/packages/jazz-run/src/config.ts
+++ b/packages/jazz-run/src/config.ts
@@ -0,0 +1,6 @@
 export const serverDefaults = {
  host: "127.0.0.1",
  port: 4200,
  inMemory: false,
  db: "sync-db/storage.db",
 };
--- a/packages/jazz-run/src/index.ts
+++ b/packages/jazz-run/src/index.ts
@@ -5,6 +5,7 @@ import { NodeContext, NodeRuntime } from "@effect/platform-node";
 import { Console, Effect } from "effect";
 import { createWorkerAccount } from "./createWorkerAccount.js";
 import { startSyncServer } from "./startSyncServer.js";
 import { serverDefaults } from "./config.js";
 const jazzTools = Command.make("jazz-tools");
@@ -39,36 +40,63 @@ const accountCommand = Command.make("account").pipe(
  Command.withSubcommands([createAccountCommand]),
 );
 const hostOption = Options.text("host")
  .pipe(Options.withAlias("h"))
  .pipe(
    Options.withDescription(
      `The host to listen on. Default is ${serverDefaults.host}`,
    ),
  )
  .pipe(Options.withDefault(serverDefaults.host));
 const portOption = Options.text("port")
  .pipe(Options.withAlias("p"))
  .pipe(
    Options.withDescription(
-      "Select a different port for the WebSocket server. Default is 4200",
+      `Select a different port for the WebSocket server. Default is ${serverDefaults.port}`,
    ),
  )
-  .pipe(Options.withDefault("4200"));
+  .pipe(Options.withDefault(serverDefaults.port.toString()));
 const inMemoryOption = Options.boolean("in-memory").pipe(
-  Options.withDescription("Use an in-memory storage instead of file-based"),
+  Options.withDescription("Use an in-memory storage instead of file-based."),
 );
 const dbOption = Options.file("db")
  .pipe(
    Options.withDescription(
-      "The path to the file where to store the data. Default is 'sync-db/storage.db'",
+      `The path to the file where to store the data. Default is '${serverDefaults.db}'`,
    ),
  )
-  .pipe(Options.withDefault("sync-db/storage.db"));
+  .pipe(Options.withDefault(serverDefaults.db));
 const startSyncServerCommand = Command.make(
  "sync",
-  { port: portOption, inMemory: inMemoryOption, db: dbOption },
+  {
-  ({ port, inMemory, db }) => {
+    host: hostOption,
    port: portOption,
    inMemory: inMemoryOption,
    db: dbOption,
  },
  ({ host, port, inMemory, db }) => {
    return Effect.gen(function* () {
-      yield* Effect.promise(() => startSyncServer({ port, inMemory, db }));
+      const server = yield* Effect.promise(() =>
        startSyncServer({ host, port, inMemory, db }),
      );
      const serverAddress = server.address();
      if (!serverAddress) {
        return yield* Effect.fail(new Error("Failed to start sync server."));
      }
      const socketAddress =
        typeof serverAddress === "object"
          ? `${serverAddress.address}:${serverAddress.port}`
          : serverAddress;
      yield* Console.log(
-        `COJSON sync server listening on ws://127.0.0.1:${port}`,
+        `COJSON sync server listening on ws://${socketAddress}`,
      );
      // Keep the server up
--- a/packages/jazz-run/src/startSyncServer.ts
+++ b/packages/jazz-run/src/startSyncServer.ts
@@ -1,4 +1,4 @@
-import { createServer, type Server } from "node:http";
+import { createServer } from "node:http";
 import { mkdir } from "node:fs/promises";
 import { dirname } from "node:path";
 import { LocalNode } from "cojson";
@@ -6,16 +6,19 @@ import { getBetterSqliteStorage } from "cojson-storage-sqlite";
 import { createWebSocketPeer } from "cojson-transport-ws";
 import { WasmCrypto } from "cojson/crypto/WasmCrypto";
 import { WebSocketServer } from "ws";
 import { type SyncServer } from "./types.js";
 export const startSyncServer = async ({
  host,
  port,
  inMemory,
  db,
 }: {
  host: string | undefined;
  port: string | undefined;
  inMemory: boolean;
  db: string;
-}) => {
+}): Promise<SyncServer> => {
  const crypto = await WasmCrypto.create();
  const server = createServer((req, res) => {
@@ -94,8 +97,6 @@ export const startSyncServer = async ({
    localNode.gracefulShutdown();
  });
  server.listen(port ? parseInt(port) : undefined);
  const _close = server.close;
  server.close = () => {
@@ -106,5 +107,11 @@ export const startSyncServer = async ({
  Object.defineProperty(server, "localNode", { value: localNode });
-  return server as Server & { localNode: LocalNode };
+  server.listen(port ? parseInt(port) : undefined, host);
  return new Promise((resolve) => {
    server.once("listening", () => {
      resolve(server as SyncServer);
    });
  });
 };
--- a/packages/jazz-run/src/tests/createWorkerAccount.test.ts
+++ b/packages/jazz-run/src/tests/createWorkerAccount.test.ts
@@ -5,11 +5,13 @@ import { describe, expect, it, onTestFinished } from "vitest";
 import { WebSocket } from "ws";
 import { createWorkerAccount } from "../createWorkerAccount.js";
 import { startSyncServer } from "../startSyncServer.js";
 import { serverDefaults } from "../config.js";
 describe("createWorkerAccount - integration tests", () => {
  it("should create a worker account using the local sync server", async () => {
    // Pass port: undefined to let the server choose a random port
    const server = await startSyncServer({
      host: serverDefaults.host,
      port: undefined,
      inMemory: true,
      db: "",
--- a/packages/jazz-run/src/tests/startSyncServer.test.ts
+++ b/packages/jazz-run/src/tests/startSyncServer.test.ts
@@ -1,24 +1,29 @@
 import { randomUUID } from "crypto";
 import { tmpdir } from "os";
 import { join } from "path";
 import { LocalNode } from "cojson";
 import { co, z } from "jazz-tools";
 import { startWorker } from "jazz-tools/worker";
-import { describe, expect, test } from "vitest";
+import { describe, expect, test, afterAll } from "vitest";
 import { createWorkerAccount } from "../createWorkerAccount.js";
 import { startSyncServer } from "../startSyncServer.js";
 import { serverDefaults } from "../config.js";
 import { unlinkSync } from "node:fs";
 const TestMap = co.map({
  value: z.string(),
 });
 const dbPath = join(tmpdir(), `test-${randomUUID()}.db`);
 afterAll(() => {
  unlinkSync(dbPath);
 });
 describe("startSyncServer", () => {
  test("persists values in storage and loads them after restart", async () => {
    // Create a temporary database file
    const dbPath = join(tmpdir(), `test-${randomUUID()}.db`);
    // Start first server instance
    const server1 = await startSyncServer({
      host: serverDefaults.host,
      port: "0", // Random available port
      inMemory: false,
      db: dbPath,
@@ -48,6 +53,7 @@ describe("startSyncServer", () => {
    // Start second server instance with same DB
    const server2 = await startSyncServer({
      host: serverDefaults.host,
      port: "0",
      inMemory: false,
      db: dbPath,
@@ -74,4 +80,21 @@ describe("startSyncServer", () => {
    await worker2.done();
    server2.close();
  });
  test("starts a sync server with a specific host and port", async () => {
    const server = await startSyncServer({
      host: "0.0.0.0",
      port: "4900",
      inMemory: false,
      db: dbPath,
    });
    expect(server.address()).toEqual({
      address: "0.0.0.0",
      port: 4900,
      family: "IPv4",
    });
    server.close();
  });
 });
--- a/packages/jazz-run/src/tests/startWorker.test.ts
+++ b/packages/jazz-run/src/tests/startWorker.test.ts
@@ -18,6 +18,7 @@ import { afterAll, describe, expect, onTestFinished, test } from "vitest";
 import { createWorkerAccount } from "../createWorkerAccount.js";
 import { startSyncServer } from "../startSyncServer.js";
 import { waitFor } from "./utils.js";
 import { serverDefaults } from "../config.js";
 const dbPath = join(tmpdir(), `test-${randomUUID()}.db`);
@@ -30,9 +31,9 @@ async function setup<
    | (AccountClass<Account> & CoValueFromRaw<Account>)
    | AnyAccountSchema,
 >(AccountSchema?: S) {
-  const { server, port } = await setupSyncServer();
+  const { server, port, host } = await setupSyncServer();
-  const syncServer = `ws://localhost:${port}`;
+  const syncServer = `ws://${host}:${port}`;
  const { worker, done, waitForConnection, subscribeToConnectionChange } =
    await setupWorker(syncServer, AccountSchema);
@@ -43,13 +44,18 @@ async function setup<
    syncServer,
    server,
    port,
    host,
    waitForConnection,
    subscribeToConnectionChange,
  };
 }
-async function setupSyncServer(defaultPort = "0") {
+async function setupSyncServer(
  defaultHost = serverDefaults.host,
  defaultPort = "0",
 ) {
  const server = await startSyncServer({
    host: defaultHost,
    port: defaultPort,
    inMemory: false,
    db: dbPath,
@@ -61,7 +67,7 @@ async function setupSyncServer(defaultPort = "0") {
    server.close();
  });
-  return { server, port };
+  return { server, port, host: defaultHost };
 }
 async function setupWorker<
@@ -258,6 +264,7 @@ describe("startWorker integration", () => {
    // Start a new sync server on the same port
    const newServer = await startSyncServer({
      host: worker1.host,
      port: worker1.port,
      inMemory: true,
      db: "",
@@ -290,6 +297,7 @@ describe("startWorker integration", () => {
    // Start a new sync server on the same port
    const newServer = await startSyncServer({
      host: worker1.host,
      port: worker1.port,
      inMemory: true,
      db: "",
@@ -326,6 +334,7 @@ describe("startWorker integration", () => {
    // Start a new sync server on the same port
    const newServer = await startSyncServer({
      host: worker1.host,
      port: worker1.port,
      inMemory: true,
      db: "",
--- a/packages/jazz-run/src/types.ts
+++ b/packages/jazz-run/src/types.ts
@@ -0,0 +1,4 @@
 import { type Server } from "node:http";
 import { type LocalNode } from "cojson";
 export type SyncServer = Server & { localNode: LocalNode };
--- a/packages/jazz-tools/CHANGELOG.md
+++ b/packages/jazz-tools/CHANGELOG.md
@@ -1,5 +1,34 @@
 # jazz-tools
 ## 0.17.9
 ### Patch Changes
 - 52ea0c7: Explicit loadAs in upsertUnique to use it without loaded context
 - Updated dependencies [7586c3b]
  - cojson@0.17.9
  - cojson-storage-indexeddb@0.17.9
  - cojson-transport-ws@0.17.9
 ## 0.17.8
 ### Patch Changes
 - ac3e694: Fixed an issue where CoValue schemas could be incorrectly passed to `co.map` and `co.profile` schema definers.
 - 6dbb053: Prosemirror: fix RangeError triggered when creating invalid HTML
 - 1a182f0: Add missing BaseProfileShape export
  - cojson@0.17.8
  - cojson-storage-indexeddb@0.17.8
  - cojson-transport-ws@0.17.8
 ## 0.17.7
 ### Patch Changes
 - cojson@0.17.7
 - cojson-storage-indexeddb@0.17.7
 - cojson-transport-ws@0.17.7
 ## 0.17.6
 ### Patch Changes
--- a/packages/jazz-tools/package.json
+++ b/packages/jazz-tools/package.json
@@ -140,7 +140,7 @@
  },
  "type": "module",
  "license": "MIT",
-  "version": "0.17.6",
+  "version": "0.17.9",
  "dependencies": {
    "@manuscripts/prosemirror-recreate-steps": "^0.1.4",
    "@scure/base": "1.2.1",
--- a/packages/jazz-tools/src/prosemirror/lib/sync.ts
+++ b/packages/jazz-tools/src/prosemirror/lib/sync.ts
@@ -1,6 +1,6 @@
 import { recreateTransform } from "@manuscripts/prosemirror-recreate-steps";
 import { CoRichText } from "jazz-tools";
-import { Transaction } from "prosemirror-state";
+import { EditorState, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 import { htmlToProseMirror, proseMirrorToHtml } from "./converter.js";
@@ -34,6 +34,8 @@ export const META_KEY = "fromJazz";
 export function createSyncHandlers(coRichText: CoRichText | undefined) {
  // Store the editor view in a closure
  let view: EditorView | undefined;
  let localChange = false;
  let remoteChange = false;
  /**
   * Handles changes from CoRichText by updating the ProseMirror editor.
@@ -47,24 +49,47 @@ export function createSyncHandlers(coRichText: CoRichText | undefined) {
   * @param newText - The updated CoRichText instance
   */
  function handleCoRichTextChange(newText: CoRichText) {
-    if (!view || !newText) return;
+    if (!view || !newText || localChange || remoteChange) return;
-    const pmDoc = htmlToProseMirror(
+    const currentView = view;
-      newText.toString(),
+    remoteChange = true;
      view.state.doc.type.schema,
    );
    const transform = recreateTransform(view.state.doc, pmDoc);
-    // Create a new transaction
+    // Changes on CoPlainText are emitted word by word, which means that it creates
-    const tr = view.state.tr;
+    // invalid intermediate states when wrapping a document with HTML tags
    // To fix the issue, we throttle the changes to the next microtask
    queueMicrotask(() => {
      const pmDoc = htmlToProseMirror(
        newText.toString(),
        currentView.state.doc.type.schema,
      );
-    // Apply all steps from the transform to the transaction
+      try {
-    transform.steps.forEach((step) => {
+        const transform = recreateTransform(currentView.state.doc, pmDoc);
-      tr.step(step);
+
        // Create a new transaction
        const tr = currentView.state.tr;
        // Apply all steps from the transform to the transaction
        transform.steps.forEach((step) => {
          tr.step(step);
        });
        tr.setMeta(META_KEY, true);
        currentView.dispatch(tr);
      } catch (err) {
        // Sometimes recreateTransform fails, so we just rebuild the doc from scratch
        const newState = EditorState.create({
          schema: currentView.state.schema,
          doc: pmDoc,
          plugins: currentView.state.plugins,
          selection: currentView.state.selection,
        });
        currentView.updateState(newState);
      } finally {
        remoteChange = false;
      }
    });
    tr.setMeta(META_KEY, true);
    view.dispatch(tr);
  }
  /**
@@ -82,7 +107,12 @@ export function createSyncHandlers(coRichText: CoRichText | undefined) {
    if (tr.docChanged) {
      const str = proseMirrorToHtml(tr.doc);
-      coRichText.applyDiff(str);
+      localChange = true;
      try {
        coRichText.applyDiff(str);
      } finally {
        localChange = false;
      }
    }
  }
--- a/packages/jazz-tools/src/prosemirror/tests/plugin.test.ts
+++ b/packages/jazz-tools/src/prosemirror/tests/plugin.test.ts
@@ -1,29 +1,33 @@
 // @vitest-environment jsdom
-import { Account, CoRichText } from "jazz-tools";
+import { CoRichText } from "jazz-tools";
 import { createJazzTestAccount, setupJazzTestSync } from "jazz-tools/testing";
 import { schema } from "prosemirror-schema-basic";
 import { EditorState, TextSelection } from "prosemirror-state";
 import { Plugin } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import {
  afterEach,
  beforeEach,
  describe,
  expect,
  it,
  onTestFinished,
 } from "vitest";
 import { createJazzPlugin } from "../lib/plugin";
 import { Schema } from "prosemirror-model";
 import { schema as basicSchema } from "prosemirror-schema-basic";
 import { addListNodes } from "prosemirror-schema-list";
-let account: Account;
+const schema = new Schema({
-let coRichText: CoRichText;
+  nodes: addListNodes(basicSchema.spec.nodes, "paragraph block*", "block"),
-let plugin: Plugin;
+  marks: basicSchema.spec.marks,
-let state: EditorState;
+});
 let view: EditorView;
 beforeEach(async () => {
  await setupJazzTestSync();
  account = await createJazzTestAccount({ isCurrentActiveAccount: true });
 async function setupTest(initialContent = "<p>Hello</p>") {
  // Create a real CoRichText with the test account as owner
-  coRichText = CoRichText.create("<p>Hello</p>", account);
+  const coRichText = CoRichText.create(initialContent);
-  plugin = createJazzPlugin(coRichText);
+  const plugin = createJazzPlugin(coRichText);
-  state = EditorState.create({
+  const state = EditorState.create({
    schema,
    plugins: [plugin],
  });
@@ -33,25 +37,32 @@ beforeEach(async () => {
  document.body.appendChild(editorElement);
  // Initialize the editor view
-  view = new EditorView(editorElement, {
+  const view = new EditorView(editorElement, {
    state,
  });
 });
-afterEach(() => {
+  onTestFinished(() => {
  // Clean up the editor view
  if (view) {
    view.destroy();
-    view.dom.remove();
+    editorElement.remove();
-  }
+  });
  return { coRichText, plugin, state, view, editorElement };
 }
 beforeEach(async () => {
  await setupJazzTestSync();
  await createJazzTestAccount({ isCurrentActiveAccount: true });
 });
 describe("createJazzPlugin", () => {
-  it("initializes editor with CoRichText content", () => {
+  it("initializes editor with CoRichText content", async () => {
    const { state } = await setupTest();
    expect(state.doc.textContent).toContain("Hello");
  });
  it("updates editor when CoRichText changes", async () => {
    const { coRichText, view } = await setupTest();
    // Update CoRichText content
    coRichText.applyDiff("<p>Updated content</p>");
@@ -61,7 +72,9 @@ describe("createJazzPlugin", () => {
    expect(view.state.doc.textContent).toContain("Updated content");
  });
-  it("updates CoRichText when editor content changes", () => {
+  it("updates CoRichText when editor content changes", async () => {
    const { coRichText, view } = await setupTest();
    // Create a transaction to update the editor content
    const tr = view.state.tr.insertText(" World", 6);
    view.dispatch(tr);
@@ -70,8 +83,8 @@ describe("createJazzPlugin", () => {
    expect(coRichText.toString()).toContain("Hello World");
  });
-  it("handles empty CoRichText initialization", () => {
+  it("handles empty CoRichText initialization", async () => {
-    const emptyCoRichText = CoRichText.create("", account);
+    const emptyCoRichText = CoRichText.create("");
    const emptyPlugin = createJazzPlugin(emptyCoRichText);
    const emptyState = EditorState.create({
      schema,
@@ -81,7 +94,7 @@ describe("createJazzPlugin", () => {
    expect(emptyState.doc.textContent).toBe("");
  });
-  it("handles undefined CoRichText", () => {
+  it("handles undefined CoRichText", async () => {
    const undefinedPlugin = createJazzPlugin(undefined);
    const undefinedState = EditorState.create({
      schema,
@@ -91,7 +104,9 @@ describe("createJazzPlugin", () => {
    expect(undefinedState.doc.textContent).toBe("");
  });
-  it("prevents infinite update loops", () => {
+  it("prevents infinite update loops", async () => {
    const { coRichText, view } = await setupTest();
    // Create a transaction that would normally trigger a CoRichText update
    const tr = view.state.tr.insertText(" Loop", 6);
@@ -106,7 +121,9 @@ describe("createJazzPlugin", () => {
    expect(coRichText.toString()).not.toContain("Loop");
  });
-  it.skip("preserves selection when CoRichText changes", () => {
+  it("preserves selection when CoRichText changes", async () => {
    const { coRichText, view } = await setupTest();
    // Set a selection in the editor
    const tr = view.state.tr.setSelection(
      TextSelection.create(view.state.doc, 2, 5),
@@ -118,10 +135,49 @@ describe("createJazzPlugin", () => {
    expect(view.state.selection.to).toBe(5);
    // Update CoRichText content
-    coRichText.applyDiff("<p>Updated content</p>");
+    coRichText.applyDiff("<p>Hello world</p>");
    await new Promise((resolve) => setTimeout(resolve, 0));
    // Verify selection is preserved after content update
    expect(view.state.selection.from).toBe(2);
    expect(view.state.selection.to).toBe(5);
  });
  it("falls back to creating a new EditorState when the transform fails", async () => {
    const { coRichText, editorElement } = await setupTest(
      "<p>A <strong>hu<em>man</strong></em>.</p>",
    );
    // Wait for the next tick to allow the update to propagate
    await new Promise((resolve) => setTimeout(resolve, 0));
    // Update CoRichText content
    coRichText.applyDiff(
      "<ol><li><p>A <strong>hu</strong><em><strong>man</strong></em>.</p></li></ol>",
    );
    // Wait for the next tick to allow the update to propagate
    await new Promise((resolve) => setTimeout(resolve, 0));
    expect(editorElement.querySelector(".ProseMirror")?.innerHTML).toBe(
      "<ol><li><p>A <strong>hu</strong><em><strong>man</strong></em>.</p></li></ol>",
    );
  });
  it("handles updates with emojis", async () => {
    const { coRichText, editorElement } = await setupTest(
      "<p>A <strong>hu</strong><em><strong>man</strong></em>.</p>",
    );
    // Update CoRichText content
    coRichText.applyDiff("<p>A human💪</p>");
    // Wait for the next tick to allow the update to propagate
    await new Promise((resolve) => setTimeout(resolve, 0));
    expect(editorElement.querySelector(".ProseMirror")?.innerHTML).toBe(
      "<p>A human💪</p>",
    );
  });
 });
--- a/packages/jazz-tools/src/react/auth/Clerk.tsx
+++ b/packages/jazz-tools/src/react/auth/Clerk.tsx
@@ -9,7 +9,7 @@ import {
 } from "jazz-tools";
 import { LocalStorageKVStore } from "jazz-tools/browser";
 import { useAuthSecretStorage, useJazzContext } from "jazz-tools/react-core";
-import { useEffect, useMemo, useState } from "react";
+import { ReactNode, useEffect, useMemo, useState } from "react";
 import { JazzProviderProps, JazzReactProvider } from "../provider.js";
 function useJazzClerkAuth(clerk: MinimalClerkClient) {
@@ -43,7 +43,9 @@ export const JazzReactProviderWithClerk = <
    | (AccountClass<Account> & CoValueFromRaw<Account>)
    | AnyAccountSchema,
 >(
-  props: { clerk: MinimalClerkClient } & JazzProviderProps<S>,
+  props: {
    clerk: MinimalClerkClient;
  } & JazzProviderProps<S>,
 ) => {
  const [isLoaded, setIsLoaded] = useState(false);
@@ -61,7 +63,7 @@ export const JazzReactProviderWithClerk = <
  }, []);
  if (!isLoaded) {
-    return null;
+    return props.fallback ?? null;
  }
  return (
--- a/packages/jazz-tools/src/react/provider.tsx
+++ b/packages/jazz-tools/src/react/provider.tsx
@@ -20,6 +20,7 @@ export type JazzProviderProps<
 > = {
  children: React.ReactNode;
  enableSSR?: boolean;
  fallback?: React.ReactNode | null;
 } & JazzContextManagerProps<S>;
 /** @category Context & Hooks */
@@ -38,6 +39,7 @@ export function JazzReactProvider<
  logOutReplacement,
  onAnonymousAccountDiscarded,
  enableSSR,
  fallback = null,
 }: JazzProviderProps<S>) {
  const [contextManager] = React.useState(
    () =>
@@ -100,7 +102,7 @@ export function JazzReactProvider<
  return (
    <JazzContext.Provider value={value}>
      <JazzContextManagerContext.Provider value={contextManager}>
-        {value && children}
+        {value ? children : fallback}
      </JazzContextManagerContext.Provider>
    </JazzContext.Provider>
  );
--- a/packages/jazz-tools/src/tools/coValues/coMap.ts
+++ b/packages/jazz-tools/src/tools/coValues/coMap.ts
@@ -628,7 +628,11 @@ export class CoMap extends CoValueBase implements CoValue {
      resolve?: RefsToResolveStrict<M, R>;
    },
  ): Promise<Resolved<M, R> | null> {
-    let mapId = CoMap._findUnique(options.unique, options.owner.id);
+    const mapId = CoMap._findUnique(
      options.unique,
      options.owner.id,
      options.owner._loadedAs,
    );
    let map: Resolved<M, R> | null = await loadCoValueWithoutMe(this, mapId, {
      ...options,
      loadAs: options.owner._loadedAs,
--- a/packages/jazz-tools/src/tools/exports.ts
+++ b/packages/jazz-tools/src/tools/exports.ts
@@ -35,6 +35,7 @@ export type {
  TextPos,
  AccountClass,
  AccountCreationProps,
  BaseProfileShape,
 } from "./internal.js";
 export {
--- a/packages/jazz-tools/src/tools/implementation/zodSchema/runtimeConverters/coValueSchemaTransformation.ts
+++ b/packages/jazz-tools/src/tools/implementation/zodSchema/runtimeConverters/coValueSchemaTransformation.ts
@@ -38,9 +38,14 @@ import {
 // Note: if you're editing this function, edit the `isAnyCoValueSchema`
 // function in `zodReExport.ts` as well
 export function isAnyCoValueSchema(
-  schema: AnyZodOrCoValueSchema | CoValueClass,
+  schema: unknown,
 ): schema is AnyCoreCoValueSchema {
-  return "collaborative" in schema && schema.collaborative === true;
+  return (
    typeof schema === "object" &&
    schema !== null &&
    "collaborative" in schema &&
    schema.collaborative === true
  );
 }
 export function isCoValueSchema(
--- a/packages/jazz-tools/src/tools/implementation/zodSchema/zodCo.ts
+++ b/packages/jazz-tools/src/tools/implementation/zodSchema/zodCo.ts
@@ -19,6 +19,7 @@ import {
  createCoreCoPlainTextSchema,
  createCoreFileStreamSchema,
  hydrateCoreCoValueSchema,
  isAnyCoValueSchema,
 } from "../../internal.js";
 import {
  CoDiscriminatedUnionSchema,
@@ -36,6 +37,11 @@ import { z } from "./zodReExport.js";
 export const coMapDefiner = <Shape extends z.core.$ZodLooseShape>(
  shape: Shape,
 ): CoMapSchema<Shape> => {
  if (isAnyCoValueSchema(shape as any)) {
    throw new Error(
      "co.map() expects an object as its argument, not a CoValue schema",
    );
  }
  const coreSchema = createCoreCoMapSchema(shape);
  return hydrateCoreCoValueSchema(coreSchema);
 };
@@ -116,6 +122,11 @@ export const coProfileDefiner = <
 >(
  shape: Shape & Partial<DefaultProfileShape> = {} as any,
 ): CoProfileSchema<Shape> => {
  if (isAnyCoValueSchema(shape as any)) {
    throw new Error(
      "co.profile() expects an object as its argument, not a CoValue schema",
    );
  }
  const ehnancedShape = Object.assign(shape, {
    name: z.string(),
    inbox: z.optional(z.string()),
--- a/packages/jazz-tools/src/tools/implementation/zodSchema/zodReExport.ts
+++ b/packages/jazz-tools/src/tools/implementation/zodSchema/zodReExport.ts
@@ -88,6 +88,11 @@ function containsCoValueSchema(shape?: core.$ZodLooseShape): boolean {
 // Note: if you're editing this function, edit the `isAnyCoValueSchema`
 // function in `zodSchemaToCoSchema.ts` as well
-function isAnyCoValueSchema(schema: any): boolean {
+function isAnyCoValueSchema(schema: unknown): boolean {
-  return "collaborative" in schema && schema.collaborative === true;
+  return (
    typeof schema === "object" &&
    schema !== null &&
    "collaborative" in schema &&
    schema.collaborative === true
  );
 }
--- a/packages/jazz-tools/src/tools/tests/account.test.ts
+++ b/packages/jazz-tools/src/tools/tests/account.test.ts
@@ -137,6 +137,12 @@ test("loading raw accounts should work", async () => {
  expect(loadedAccount.profile!.name).toBe("test 1");
 });
 test("co.profile() should throw an error if passed a CoValue schema", async () => {
  expect(() => co.profile(co.map({}))).toThrow(
    "co.profile() expects an object as its argument, not a CoValue schema",
  );
 });
 test("should support recursive props on co.profile", async () => {
  const User = co.profile({
    name: z.string(),
--- a/packages/jazz-tools/src/tools/tests/coMap.test.ts
+++ b/packages/jazz-tools/src/tools/tests/coMap.test.ts
@@ -2325,6 +2325,12 @@ describe("co.map schema", () => {
      expect(draftPerson.extraField).toEqual("extra");
    });
  });
  test("co.map() should throw an error if passed a CoValue schema", () => {
    expect(() => co.map(co.map({}))).toThrow(
      "co.map() expects an object as its argument, not a CoValue schema",
    );
  });
 });
 describe("Updating a nested reference", () => {
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2038,19 +2038,19 @@ importers:
        specifier: ^0.25.5
        version: 0.25.8(effect@3.11.9)
      cojson:
-        specifier: workspace:0.17.6
+        specifier: workspace:0.17.9
        version: link:../cojson
      cojson-storage-sqlite:
-        specifier: workspace:0.17.6
+        specifier: workspace:0.17.9
        version: link:../cojson-storage-sqlite
      cojson-transport-ws:
-        specifier: workspace:0.17.6
+        specifier: workspace:0.17.9
        version: link:../cojson-transport-ws
      effect:
        specifier: ^3.6.5
        version: 3.11.9
      jazz-tools:
-        specifier: workspace:0.17.6
+        specifier: workspace:0.17.9
        version: link:../jazz-tools
      ws:
        specifier: ^8.14.2
--- a/starters/react-passkey-auth/CHANGELOG.md
+++ b/starters/react-passkey-auth/CHANGELOG.md
@@ -1,5 +1,27 @@
 # jazz-react-tailwind-starter
 ## 0.0.153
 ### Patch Changes
 - Updated dependencies [52ea0c7]
  - jazz-tools@0.17.9
 ## 0.0.152
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
 ## 0.0.151
 ### Patch Changes
 - jazz-tools@0.17.7
 ## 0.0.150
 ### Patch Changes
--- a/starters/react-passkey-auth/package.json
+++ b/starters/react-passkey-auth/package.json
@@ -1,7 +1,7 @@
 {
  "name": "jazz-react-passkey-auth-starter",
  "private": true,
-  "version": "0.0.150",
+  "version": "0.0.153",
  "type": "module",
  "scripts": {
    "dev": "vite",
--- a/starters/svelte-passkey-auth/CHANGELOG.md
+++ b/starters/svelte-passkey-auth/CHANGELOG.md
@@ -1,5 +1,27 @@
 # svelte-passkey-auth
 ## 0.0.127
 ### Patch Changes
 - Updated dependencies [52ea0c7]
  - jazz-tools@0.17.9
 ## 0.0.126
 ### Patch Changes
 - Updated dependencies [ac3e694]
 - Updated dependencies [6dbb053]
 - Updated dependencies [1a182f0]
  - jazz-tools@0.17.8
 ## 0.0.125
 ### Patch Changes
 - jazz-tools@0.17.7
 ## 0.0.124
 ### Patch Changes
--- a/starters/svelte-passkey-auth/package.json
+++ b/starters/svelte-passkey-auth/package.json
@@ -1,6 +1,6 @@
 {
  "name": "svelte-passkey-auth",
-  "version": "0.0.124",
+  "version": "0.0.127",
  "type": "module",
  "private": true,
  "scripts": {
Author	SHA1	Message	Date
Guido D'Orsi	4c2e60ab51	Merge pull request #2776 from garden-co/changeset-release/main Version Packages	2025-08-20 13:25:30 +02:00
github-actions[bot]	1830171930	Version Packages	2025-08-20 10:59:08 +00:00
Guido D'Orsi	6574090402	Merge pull request #2777 from garden-co/fix/load-as-upsertUnique Explicit loadAs in upsertUnique to use it without loaded context	2025-08-20 12:55:18 +02:00
Guido D'Orsi	a6f65472a7	Merge pull request #2779 from ccssmnn/add-fallback-components Add Fallback properties to JazzProvider and ClerkProvider	2025-08-20 12:54:16 +02:00
Guido D'Orsi	109952aa6a	Merge pull request #2781 from garden-co/gio/setup-codeowners chore: setup codeowners	2025-08-20 12:50:38 +02:00
Giordano Ricci	556bdf977b	more tweaking	2025-08-20 11:41:31 +01:00
Giordano Ricci	0213b4e5b9	add ui	2025-08-20 11:31:54 +01:00
Giordano Ricci	01c195756c	add docs	2025-08-20 11:27:17 +01:00
Giordano Ricci	9c69917d24	add @garden-co/framework as owner of all packages	2025-08-20 11:03:18 +01:00
Giordano Ricci	b4d68f0a32	wip: setup codeowners	2025-08-20 10:59:36 +01:00
Guido D'Orsi	fbc3839777	chore: simplify the fallback on the react provider	2025-08-20 11:55:45 +02:00
Guido D'Orsi	296464b282	Merge pull request #2753 from garden-co/GCO-642-clarify-docs-adding-group-members-by-id Closes #GCO-642 - Clarify docs for adding group members by id	2025-08-20 11:50:03 +02:00
Carl Assmann	c463654970	no need to add fallback to clerk, bc it extends and forwards jazzproviderprops	2025-08-19 23:23:19 +02:00
Carl Assmann	debc052bdc	add fallback to clerk example	2025-08-19 23:12:12 +02:00
Carl Assmann	3c7846153d	add fallback properties to JazzProvider and ClerkProvider	2025-08-19 23:00:06 +02:00
Meg Culotta	e410fedda7	Merge pull request #2736 from garden-co/#GCO-691-Adds-node-20-troubleshooting-docs Closes GCO-691, GCO-731 - Add setup troubleshooting page	2025-08-19 14:40:47 -05:00
Matteo Manchi	52ea0c7a9b	fix(jazz-tools/tools): explicit loadAs in upsertUnique to use it without loaded context	2025-08-19 18:21:31 +02:00
Guido D'Orsi	b91c93caed	Merge pull request #2769 from garden-co/justin-gco-741-skip-session-transaction-verification-in-core-node Ref GCO-741: Add option for disabling transaction verification to SyncManager	2025-08-19 18:03:02 +02:00
Justin Rosenthal	7586c3bac5	Add changeset	2025-08-19 08:52:44 -07:00
Justin Rosenthal	9b96cd4a65	Craft an invalid transaction in unit test	2025-08-19 08:50:43 -07:00
Justin Rosenthal	2e66ea8e56	Revert signatures to positional args	2025-08-19 08:32:38 -07:00
Guido D'Orsi	336cc1f0fe	Merge pull request #2773 from garden-co/changeset-release/main Version Packages	2025-08-19 16:27:36 +02:00
github-actions[bot]	cc2ca5c23c	Version Packages	2025-08-19 14:26:38 +00:00
Guido D'Orsi	3664385113	Merge pull request #2775 from garden-co/fix/comap-coprofile-validate-input fix: prevent passing CoValue schemas to `co.map` and `co.profile`	2025-08-19 16:22:45 +02:00
Guido D'Orsi	2b2ecdaf3d	Merge pull request #2771 from garden-co/feat/rich-text-prosemirror-fix fix(prosemirror): fix RangeError triggered when creating invalid HTML	2025-08-19 16:21:39 +02:00
Guido D'Orsi	6dbb05320a	fix(prosemirror): fix RangeError triggered when creating invalid HTML	2025-08-19 16:15:12 +02:00
Margaret Culotta	0160a188fa	Remove strict casting from example	2025-08-19 09:06:58 -05:00
NicoR	ac3e694f4e	fix: prevent passing CoValue schemas to `co.map` and `co.profile`	2025-08-19 11:05:54 -03:00
Margaret Culotta	a7dca75955	Clean up unnecessary content per PR feedback	2025-08-19 08:29:24 -05:00
Guido D'Orsi	143156cd6a	Merge pull request #2772 from garden-co/gio/add-missing-export fix: add missing export	2025-08-19 14:31:57 +02:00
Giordano Ricci	1a182f07de	add changeset	2025-08-19 13:30:30 +01:00
Giordano Ricci	7e7e7ebb51	fix: add missing export	2025-08-19 13:28:45 +01:00
Guido D'Orsi	0966a90f3d	Merge pull request #2768 from garden-co/changeset-release/main Version Packages	2025-08-19 08:44:03 +02:00
Justin Rosenthal	76f142b70d	Add ability to disable verification in SyncManager	2025-08-18 14:52:58 -07:00
github-actions[bot]	cd2f0846db	Version Packages	2025-08-18 20:33:16 +00:00
Guido D'Orsi	c2e411d056	Merge pull request #2759 from 0x100101/feat/sync-server-host-opt Add host option to the jazz-run sync command	2025-08-18 22:31:01 +02:00
Justin Rosenthal	0167153da2	Use named parameters in tryAddTransactions() signatures	2025-08-18 13:19:26 -07:00
0x100101	feaa69ebdd	Add patch file	2025-08-18 10:04:04 -05:00
0x100101	d5fa172b17	Update docs	2025-08-17 20:46:12 -05:00
0x100101	96de15593b	Add and update tests. Tweak sync server return.	2025-08-17 20:32:22 -05:00
0x100101	5ba03ebc70	Add host option to startSyncServerCommand command	2025-08-17 16:10:04 -05:00
Margaret Culotta	d8ae47c4d1	Clarify docs for adding group members by id	2025-08-15 15:01:38 -05:00
Margaret Culotta	92c0048984	add setup troubleshooting page	2025-08-14 10:32:22 -05:00