jazz-tools 0.20.10 → 2.0.0-alpha.0

package/README.md

@@ -1,11 +1,25 @@
-# `jazz-tools`
+# jazz-tools
 
-The base implementation for Jazz (see [jazz.tools](https://jazz.tools)), a framework for distributed state.
+CLI package for Jazz 2.
 
-Provides a high-level API around the CoJSON protocol.
+## Usage
 
-## Environments and bindings
+```bash
+npx jazz-tools@alpha server
+```
 
-- `jazz-tools/browser` (Vanilla JavaScript)
-    - `jazz-react` (React apps)
-- `jazz-tools/worker` (NodeJS or Bun server workers)
+To use a specific prerelease:
+
+```bash
+npx jazz-tools@2.0.0-alpha.0 server
+```
+
+## Supported binary targets
+
+- macOS arm64
+- macOS x64
+- Linux x64
+- Linux arm64
+- Windows x64
+
+If your platform is not supported in the npm package, install with Cargo from source.

package/bin/jazz-tools.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BINARIES = {
+  "darwin-arm64": "jazz-tools-darwin-arm64",
+  "darwin-x64": "jazz-tools-darwin-x64",
+  "linux-arm64": "jazz-tools-linux-arm64",
+  "linux-x64": "jazz-tools-linux-x64",
+  "win32-x64": "jazz-tools-windows-x64.exe",
+};
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+const key = `${process.platform}-${process.arch}`;
+const binaryName = BINARIES[key];
+const here = dirname(fileURLToPath(import.meta.url));
+const localBinaryName = process.platform === "win32" ? "jazz-tools.exe" : "jazz-tools";
+const fallbackCandidates = [
+  join(here, "..", "..", "..", "target", "debug", localBinaryName),
+  join(here, "..", "..", "..", "target", "release", localBinaryName),
+];
+
+const bundledBinaryPath = binaryName ? join(here, "native", binaryName) : undefined;
+const binaryPath =
+  (bundledBinaryPath && existsSync(bundledBinaryPath) ? bundledBinaryPath : undefined) ??
+  fallbackCandidates.find((candidate) => existsSync(candidate));
+
+if (!binaryPath) {
+  const lines = [];
+  if (!binaryName) {
+    lines.push(
+      `jazz-tools does not include a bundled binary for ${process.platform}/${process.arch}.`,
+    );
+  } else {
+    lines.push(`Bundled binary missing: ${binaryName}`);
+    lines.push("This package may be corrupted or published without target artifacts.");
+  }
+  lines.push("No local Cargo build was found in target/debug or target/release.");
+  lines.push("Run `cargo build -p jazz-tools --bin jazz-tools --features cli` to build locally.");
+  fail(lines.join("\n"));
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+if (result.error) {
+  fail(`Failed to execute ${binaryName}: ${result.error.message}`);
+}
+
+if (typeof result.status === "number") {
+  process.exit(result.status);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(1);

package/package.json

@@ -1,326 +1,63 @@
 {
   "name": "jazz-tools",
-  "module": "dist/index.js",
+  "version": "2.0.0-alpha.0",
+  "description": "Jazz TypeScript SDK, React bindings, and CLI tools",
+  "bin": {
+    "jazz-tools": "bin/jazz-tools.js"
+  },
+  "files": [
+    "bin/**",
+    "dist/**",
+    "README.md"
+  ],
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "@jazz-tools/source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./testing": {
-      "@jazz-tools/source": "./src/testing.ts",
-      "types": "./dist/testing.d.ts",
-      "default": "./dist/testing.js"
-    },
-    "./ssr": {
-      "@jazz-tools/source": "./src/tools/ssr/index.ts",
-      "types": "./dist/tools/ssr/ssr.d.ts",
-      "default": "./dist/tools/ssr.js"
-    },
-    "./browser": {
-      "@jazz-tools/source": "./src/browser/index.ts",
-      "types": "./dist/browser/index.d.ts",
-      "default": "./dist/browser/index.js"
-    },
-    "./media": {
-      "@jazz-tools/source": "./src/media/index.ts",
-      "react-native": {
-        "types": "./dist/media/index.native.d.ts",
-        "default": "./dist/media/index.native.js"
-      },
-      "browser": {
-        "types": "./dist/media/index.browser.d.ts",
-        "default": "./dist/media/index.browser.js"
-      },
-      "node": {
-        "@jazz-tools/source": "./src/media/index.server.ts",
-        "types": "./dist/media/index.server.d.ts",
-        "default": "./dist/media/index.server.js"
-      },
-      "types": "./dist/media/index.d.ts",
-      "default": "./dist/media/index.js"
-    },
-    "./media/server": {
-      "@jazz-tools/source": "./src/media/index.server.ts",
-      "types": "./dist/media/index.server.d.ts",
-      "default": "./dist/media/index.server.js"
-    },
-    "./expo": {
-      "@jazz-tools/source": "./src/expo/index.ts",
-      "types": "./dist/expo/index.d.ts",
-      "default": "./dist/expo/index.js"
-    },
-    "./expo/testing": {
-      "@jazz-tools/source": "./src/expo/testing.tsx",
-      "types": "./dist/expo/testing.d.ts",
-      "default": "./dist/expo/testing.js"
-    },
-    "./expo/polyfills": {
-      "@jazz-tools/source": "./src/react-native-core/polyfills/index.js",
-      "default": "./dist/expo/polyfills.js"
-    },
-    "./inspector": {
-      "@jazz-tools/source": "./src/inspector/index.ts",
-      "types": "./dist/inspector/index.d.ts",
-      "default": "./dist/inspector/index.js"
-    },
-    "./inspector/standalone": {
-      "@jazz-tools/source": "./src/inspector/standalone.tsx",
-      "types": "./dist/inspector/standalone.d.ts",
-      "default": "./dist/inspector/standalone.js"
-    },
-    "./inspector/register-custom-element": {
-      "@jazz-tools/source": "./src/inspector/register-custom-element.ts",
-      "types": "./dist/inspector/register-custom-element.d.ts",
-      "default": "./dist/inspector/register-custom-element.js"
-    },
-    "./prosemirror": {
-      "@jazz-tools/source": "./src/prosemirror/index.ts",
-      "types": "./dist/prosemirror/index.d.ts",
-      "default": "./dist/prosemirror/index.js"
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
     },
     "./react": {
-      "@jazz-tools/source": "./src/react/index.ts",
       "types": "./dist/react/index.d.ts",
       "default": "./dist/react/index.js"
     },
-    "./react/ssr": {
-      "@jazz-tools/source": "./src/react/ssr.ts",
-      "types": "./dist/react/ssr.d.ts",
-      "default": "./dist/react/ssr.js"
-    },
-    "./react/testing": {
-      "@jazz-tools/source": "./src/react/testing.tsx",
-      "types": "./dist/react/testing.d.ts",
-      "default": "./dist/react/testing.js"
-    },
-    "./react-core": {
-      "@jazz-tools/source": "./src/react-core/index.ts",
-      "types": "./dist/react-core/index.d.ts",
-      "default": "./dist/react-core/index.js"
-    },
-    "./react-core/testing": {
-      "@jazz-tools/source": "./src/react-core/testing.tsx",
-      "types": "./dist/react-core/testing.d.ts",
-      "default": "./dist/react-core/testing.js"
-    },
-    "./react-native": {
-      "@jazz-tools/source": "./src/react-native/index.ts",
-      "types": "./dist/react-native/index.d.ts",
-      "default": "./dist/react-native/index.js"
-    },
-    "./react-native/testing": {
-      "@jazz-tools/source": "./src/react-native/testing.tsx",
-      "types": "./dist/react-native/testing.d.ts",
-      "default": "./dist/react-native/testing.js"
-    },
-    "./react-native/polyfills": {
-      "@jazz-tools/source": "./src/react-native-core/polyfills/index.js",
-      "default": "./dist/react-native/polyfills.js"
-    },
-    "./react-native-core": {
-      "@jazz-tools/source": "./src/react-native-core/index.ts",
-      "types": "./dist/react-native-core/index.d.ts",
-      "default": "./dist/react-native-core/index.js"
-    },
-    "./react-native-core/testing": {
-      "@jazz-tools/source": "./src/react-native-core/testing.tsx",
-      "types": "./dist/react-native-core/testing.d.ts",
-      "default": "./dist/react-native-core/testing.js"
-    },
-    "./svelte": {
-      "svelte": "./dist/svelte/index.js",
-      "@jazz-tools/source": "./src/svelte/index.ts",
-      "types": "./dist/svelte/index.d.ts",
-      "default": "./dist/svelte/index.js"
-    },
-    "./svelte/testing": {
-      "svelte": "./dist/svelte/testing.js",
-      "@jazz-tools/source": "./src/svelte/testing.ts",
-      "types": "./dist/svelte/testing.d.ts",
-      "default": "./dist/svelte/testing.js"
-    },
-    "./tiptap": {
-      "@jazz-tools/source": "./src/tiptap/index.ts",
-      "types": "./dist/tiptap/index.d.ts",
-      "default": "./dist/tiptap/index.js"
-    },
-    "./worker": {
-      "@jazz-tools/source": "./src/worker/index.ts",
-      "types": "./dist/worker/index.d.ts",
-      "default": "./dist/worker/index.js"
-    },
-    "./better-auth/auth/client": {
-      "@jazz-tools/source": "./src/better-auth/auth/client.ts",
-      "types": "./dist/better-auth/auth/client.d.ts",
-      "default": "./dist/better-auth/auth/client.js"
-    },
-    "./better-auth/auth/react": {
-      "@jazz-tools/source": "./src/better-auth/auth/react.tsx",
-      "types": "./dist/better-auth/auth/react.d.ts",
-      "default": "./dist/better-auth/auth/react.js"
-    },
-    "./better-auth/auth/svelte": {
-      "svelte": "./dist/better-auth/auth/svelte.svelte",
-      "@jazz-tools/source": "./src/better-auth/auth/svelte.svelte",
-      "types": "./dist/better-auth/auth/svelte.d.ts",
-      "default": "./dist/better-auth/auth/svelte.svelte"
-    },
-    "./better-auth/auth/server": {
-      "@jazz-tools/source": "./src/better-auth/auth/server.ts",
-      "types": "./dist/better-auth/auth/server.d.ts",
-      "default": "./dist/better-auth/auth/server.js"
-    },
-    "./better-auth/database-adapter": {
-      "@jazz-tools/source": "./src/better-auth/database-adapter/index.ts",
-      "types": "./dist/better-auth/database-adapter/index.d.ts",
-      "default": "./dist/better-auth/database-adapter/index.js"
-    },
-    "./load-edge-wasm": {
-      "@jazz-tools/source": "./src/worker/edge-wasm.ts",
-      "types": "./dist/worker/edge-wasm.d.ts",
-      "default": "./dist/worker/edge-wasm.js"
-    },
-    "./wasm": {
-      "@jazz-tools/source": "./src/worker/wasm.ts",
-      "types": "./dist/worker/wasm.d.ts",
-      "default": "./dist/worker/wasm.js"
-    },
-    "./napi": {
-      "@jazz-tools/source": "./src/worker/napi-crypto.ts",
-      "types": "./dist/worker/napi-crypto.d.ts",
-      "default": "./dist/worker/napi-crypto.js"
-    }
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "scripts": {
+    "build": "tsc && cp src/worker/groove-worker.ts dist/worker/groove-worker.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "test:browser": "vitest run --config vitest.config.browser.ts",
+    "stage:local": "node scripts/stage-local-binary.mjs",
+    "pack:dry-run": "npm pack --dry-run"
   },
-  "type": "module",
-  "license": "MIT",
-  "version": "0.20.10",
   "dependencies": {
-    "@scure/base": "1.2.1",
-    "@scure/bip39": "^1.3.0",
-    "@tiptap/core": "^2.12.0",
-    "clsx": "^2.0.0",
-    "fast-myers-diff": "^3.2.0",
-    "goober": "^2.1.18",
-    "prosemirror-example-setup": "^1.2.2",
-    "prosemirror-menu": "^1.2.4",
-    "prosemirror-model": "^1.21.1",
-    "prosemirror-schema-basic": "^1.2.2",
-    "prosemirror-state": "^1.4.3",
-    "prosemirror-transform": "^1.9.0",
-    "use-sync-external-store": "^1.5.0",
-    "zod": "4.1.11",
-    "cojson": "0.20.10",
-    "cojson-storage-indexeddb": "0.20.10",
-    "cojson-transport-ws": "0.20.10"
+    "groove-wasm": "workspace:*",
+    "tsx": "^4.0.0"
   },
   "devDependencies": {
-    "@scure/bip39": "^1.3.0",
-    "@sveltejs/package": "^2.0.0",
-    "@sveltejs/vite-plugin-svelte": "^6.1.0",
-    "@testing-library/dom": "^10.4.0",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "16.2.0",
-    "@testing-library/svelte": "^5.2.6",
-    "@types/react": "19.1.0",
-    "@types/react-dom": "19.1.0",
-    "@types/use-sync-external-store": "^1.5.0",
-    "libsql": "^0.5.13",
-    "msw": "^2.10.3",
-    "oauth2-mock-server": "^8.1.0",
-    "playwright": "^1.50.1",
-    "queueueue": "^4.1.2",
-    "react-error-boundary": "^6.0.0",
-    "tsup": "8.5.0",
-    "typescript": "5.6.2",
-    "vitest": "4.0.16",
-    "ws": "^8.14.2"
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@vitest/browser": "catalog:default",
+    "@vitest/browser-playwright": "catalog:default",
+    "fake-indexeddb": "^5.0.2",
+    "typescript": "^5.3.0",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.5.0",
+    "vitest": "catalog:default"
   },
   "peerDependencies": {
-    "@bam.tech/react-native-image-resizer": "*",
-    "@op-engineering/op-sqlite": "*",
-    "@react-native-community/netinfo": "*",
-    "better-auth": "^1.4.7",
-    "expo-file-system": "*",
-    "expo-image-manipulator": "*",
-    "expo-secure-store": "*",
-    "expo-sqlite": "*",
-    "react": "*",
-    "react-dom": "*",
-    "react-native": "*",
-    "react-native-fast-encoder": "^0.3.1",
-    "react-native-mmkv": "^3.3.0",
-    "react-native-nitro-modules": "^0.26.4",
-    "react-native-passkey": "^3.0.0",
-    "sharp": "^0.33.5",
-    "svelte": "^5.0.0"
+    "react": "^18 || ^19"
   },
-  "peerDependenciesMeta": {
-    "@bam.tech/react-native-image-resizer": {
-      "optional": true
-    },
-    "@op-engineering/op-sqlite": {
-      "optional": true
-    },
-    "@react-native-community/netinfo": {
-      "optional": true
-    },
-    "better-auth": {
-      "optional": true
-    },
-    "expo-image-manipulator": {
-      "optional": true
-    },
-    "expo-file-system": {
-      "optional": true
-    },
-    "expo-secure-store": {
-      "optional": true
-    },
-    "expo-sqlite": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "react-native": {
-      "optional": true
-    },
-    "react-native-fast-encoder": {
-      "optional": true
-    },
-    "react-native-mmkv": {
-      "optional": true
-    },
-    "react-native-nitro-modules": {
-      "optional": true
-    },
-    "react-native-passkey": {
-      "optional": true
-    },
-    "sharp": {
-      "optional": true
-    },
-    "svelte": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "check": "tsc --noEmit",
-    "format-and-lint": "biome check .",
-    "format-and-lint:fix": "biome check . --write",
-    "dev": "tsup --watch",
-    "bench": "vitest bench --run --root ../../ --project jazz-tools",
-    "test": "vitest --run --root ../../ --project jazz-tools",
-    "test:watch": "vitest --watch --root ../../ --project jazz-tools",
-    "types": "tsc --outDir dist",
-    "build:svelte": "rm -rf dist/svelte && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
-    "build:better-auth-svelte": "mkdir -p dist/better-auth/auth && svelte-package -i src/better-auth/auth -o dist/better-auth/auth-temp --tsconfig tsconfig.svelte.json && cp dist/better-auth/auth-temp/svelte.svelte dist/better-auth/auth/svelte.svelte && cp dist/better-auth/auth-temp/svelte.svelte.d.ts dist/better-auth/auth/svelte.d.ts && rm -rf dist/better-auth/auth-temp",
-    "build": "tsup && pnpm types && pnpm build:svelte && pnpm build:better-auth-svelte"
+  "engines": {
+    "node": ">=20"
   }
-}
+}

package/.svelte-kit/__package__/client.d.ts

@@ -1,29 +0,0 @@
-import type { Account, AuthSecretStorage, JazzContextType } from "jazz-tools";
-import type { jazzPlugin } from "./server.js";
-/**
- * @example
- * ```ts
- * const auth = betterAuth({
- *   plugins: [jazzPluginClient()],
- * });
- * ```
- */
-export declare const jazzPluginClient: () => {
-    id: "jazz-plugin";
-    $InferServerPlugin: ReturnType<typeof jazzPlugin>;
-    getActions: ($fetch: import("@better-fetch/fetch").BetterFetch, $store: import("better-auth").ClientStore) => {
-        jazz: {
-            setJazzContext: (context: JazzContextType<Account>) => void;
-            setAuthSecretStorage: (storage: AuthSecretStorage) => void;
-        };
-    };
-    fetchPlugins: {
-        id: string;
-        name: string;
-        hooks: {
-            onRequest<T extends Record<string, any>>(context: import("@better-fetch/fetch").RequestContext<T>): Promise<void>;
-            onSuccess(context: import("@better-fetch/fetch").SuccessContext<any>): Promise<void>;
-        };
-    }[];
-};
-//# sourceMappingURL=client.d.ts.map

package/.svelte-kit/__package__/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/better-auth/auth/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EAEjB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;wBAmBC,UAAU,CAAC,OAAO,UAAU,CAAC;;;sCAIvB,eAAe,CAAC,OAAO,CAAC;4CAGlB,iBAAiB;;;;;;;;;;;CA+H1D,CAAC"}

package/.svelte-kit/__package__/client.js

@@ -1,140 +0,0 @@
-const SIGNUP_URLS = [
-    "/sign-up",
-    "/sign-in/social",
-    "/sign-in/oauth2",
-    "/email-otp/send-verification-otp",
-];
-/**
- * @example
- * ```ts
- * const auth = betterAuth({
- *   plugins: [jazzPluginClient()],
- * });
- * ```
- */
-export const jazzPluginClient = () => {
-    let jazzContext;
-    let authSecretStorage;
-    let signOutUnsubscription;
-    const authenticateOnJazz = async (jazzAuth) => {
-        const parsedJazzAuth = {
-            ...jazzAuth,
-            secretSeed: jazzAuth.secretSeed
-                ? Uint8Array.from(jazzAuth.secretSeed)
-                : undefined,
-        };
-        await jazzContext.authenticate(parsedJazzAuth);
-        await authSecretStorage.set(parsedJazzAuth);
-    };
-    return {
-        id: "jazz-plugin",
-        $InferServerPlugin: {},
-        getActions: ($fetch, $store) => {
-            return {
-                jazz: {
-                    setJazzContext: (context) => {
-                        jazzContext = context;
-                    },
-                    setAuthSecretStorage: (storage) => {
-                        authSecretStorage = storage;
-                        if (signOutUnsubscription)
-                            signOutUnsubscription();
-                        // This is a workaround to logout from Better Auth when user logs out directly from Jazz
-                        signOutUnsubscription = authSecretStorage.onUpdate((isAuthenticated) => {
-                            if (isAuthenticated === false) {
-                                const session = $store.atoms.session?.get();
-                                if (!session)
-                                    return;
-                                // if the user logs out from Better Auth, the get session is immediately called
-                                // so we must wait the next fetched session to understand if we need to call sign-out
-                                if (session.isPending || session.isRefetching) {
-                                    // listen once for next session's data
-                                    const unsub = $store.atoms.session?.listen((session) => {
-                                        unsub?.();
-                                        // if the session is null, user has been already logged out from Better Auth
-                                        if (session.data !== null) {
-                                            $fetch("/sign-out", { method: "POST" });
-                                        }
-                                    });
-                                }
-                                // if the session is not pending, it means user logged out from Jazz only
-                                // so we call the sign-out api
-                                else {
-                                    $fetch("/sign-out", { method: "POST" });
-                                }
-                            }
-                        });
-                    },
-                },
-            };
-        },
-        fetchPlugins: [
-            {
-                id: "jazz-plugin",
-                name: "jazz-plugin",
-                hooks: {
-                    async onRequest(context) {
-                        if (SIGNUP_URLS.some((url) => context.url.toString().includes(url))) {
-                            const credentials = await authSecretStorage.get();
-                            if (!credentials) {
-                                throw new Error("Jazz credentials not found");
-                            }
-                            context.headers.set("x-jazz-auth", JSON.stringify({
-                                accountID: credentials.accountID,
-                                secretSeed: credentials.secretSeed
-                                    ? Array.from(credentials.secretSeed)
-                                    : undefined,
-                                accountSecret: credentials.accountSecret,
-                            }));
-                        }
-                    },
-                    async onSuccess(context) {
-                        if (context.request.url.toString().includes("/sign-up")) {
-                            await authenticateOnJazz(context.data.jazzAuth);
-                            return;
-                        }
-                        if (context.request.url.toString().includes("/sign-in/email")) {
-                            await authenticateOnJazz(context.data.jazzAuth);
-                            return;
-                        }
-                        if (context.request.url.toString().includes("/get-session")) {
-                            if (context.data === null) {
-                                if (authSecretStorage.isAuthenticated === true) {
-                                    console.info("Jazz is authenticated, but the session is null. Logging out");
-                                    await jazzContext.logOut();
-                                }
-                                return;
-                            }
-                            if (!context.data?.user) {
-                                return;
-                            }
-                            if (authSecretStorage.isAuthenticated === false) {
-                                console.info("Jazz is not authenticated, using Better Auth stored credentials");
-                                await authenticateOnJazz(context.data.jazzAuth);
-                                return;
-                            }
-                            const sessionAccountID = context.data.user.accountID;
-                            const credentials = await authSecretStorage.get();
-                            if (!credentials) {
-                                throw new Error("Jazz credentials not found");
-                            }
-                            if (credentials.accountID !== sessionAccountID) {
-                                console.info("Jazz credentials mismatch, using Better Auth stored credentials");
-                                await authenticateOnJazz(context.data.jazzAuth);
-                            }
-                            return;
-                        }
-                        if (context.request.url.toString().includes("/sign-out")) {
-                            await jazzContext.logOut();
-                            return;
-                        }
-                        if (context.request.url.toString().includes("/delete-user")) {
-                            await jazzContext.logOut();
-                            return;
-                        }
-                    },
-                },
-            },
-        ],
-    };
-};