Sync common-v8 changes: Refactor APIs, improve resource handling, and update dependencies

apps/relay/src/startBunRelay.ts

@@ -2,7 +2,7 @@ import {
   type CreateSqliteDriverDep,
   callback,
   createSqlite,
-  getOk,
+  getOrThrow,
   isPromiseLike,
   type OwnerId,
   ok,
@@ -99,7 +99,7 @@ export const startBunRelay =
     const console = _run.deps.console.child("relay");
 
     const relayName = name ?? SimpleName.orThrow("evolu-relay");
-    const sqlite = getOk(await stack.use(createSqlite(relayName)));
+    const sqlite = getOrThrow(await stack.use(createSqlite(relayName)));
     const deps = { ..._run.deps, sqlite };
 
     createBaseSqliteStorageTables(deps);

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.6/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",

examples/angular-vite-pwa/package.json

@@ -9,15 +9,15 @@
     "generate-pwa-assets": "pwa-assets-generator"
   },
   "dependencies": {
-    "@angular/core": "^21.2.1",
-    "@angular/platform-browser": "^21.2.1",
+    "@angular/core": "^21.2.2",
+    "@angular/platform-browser": "^21.2.2",
     "@evolu/common": "workspace:*",
     "@evolu/web": "workspace:*"
   },
   "devDependencies": {
     "@analogjs/vite-plugin-angular": "^2.3.1",
     "@angular/build": "^21.2.1",
-    "@angular/compiler-cli": "^21.2.1",
+    "@angular/compiler-cli": "^21.2.2",
     "@tailwindcss/vite": "^4.2.1",
     "@vite-pwa/assets-generator": "^1.0.2",
     "tailwindcss": "^4.2.1",

examples/react-electron/components/EvoluMinimalExample.tsx

@@ -88,7 +88,7 @@ const todosQuery = createQuery((db) =>
     // (even if defined without nullOr in the schema) to allow schema
     // evolution without migrations. Filter nulls with where + $narrowType.
     .where("title", "is not", null)
-    .$narrowType<{ title: Evolu.kysely.NotNull }>()
+    .$narrowType<{ title: Evolu.KyselyNotNull }>()
     // Columns createdAt, updatedAt, isDeleted are auto-added to all tables.
     .orderBy("createdAt"),
 );

examples/react-expo/app/index.tsx

@@ -54,7 +54,7 @@ const todosQuery = createQuery((db) =>
     // (even if defined without nullOr in the schema) to allow schema
     // evolution without migrations. Filter nulls with where + $narrowType.
     .where("title", "is not", null)
-    .$narrowType<{ title: Evolu.kysely.NotNull }>()
+    .$narrowType<{ title: Evolu.KyselyNotNull }>()
     // Columns createdAt, updatedAt, isDeleted are auto-added to all tables.
     .orderBy("createdAt"),
 );

examples/react-expo/package.json

@@ -39,7 +39,7 @@
     "react-native": "0.84.1",
     "react-native-nitro-modules": "0.34.1",
     "react-native-quick-crypto": "^1.0.16",
-    "react-native-safe-area-context": "^5.6.2",
+    "react-native-safe-area-context": "^5.7.0",
     "react-native-screens": "^4.24.0",
     "react-native-svg": "15.15.3",
     "react-native-web": "^0.21.0",

examples/react-nextjs/components/EvoluMinimalExample.tsx

@@ -90,7 +90,7 @@ const todosQuery = createQuery((db) =>
     // (even if defined without nullOr in the schema) to allow schema
     // evolution without migrations. Filter nulls with where + $narrowType.
     .where("title", "is not", null)
-    .$narrowType<{ title: Evolu.kysely.NotNull }>()
+    .$narrowType<{ title: Evolu.KyselyNotNull }>()
     // Columns createdAt, updatedAt, isDeleted are auto-added to all tables.
     .orderBy("createdAt"),
 );

examples/react-vite-pwa/src/components/EvoluMinimalExample.tsx

@@ -100,7 +100,7 @@ const todosQuery = createQuery((db) =>
     // (even if defined without nullOr in the schema) to allow schema
     // evolution without migrations. Filter nulls with where + $narrowType.
     .where("title", "is not", null)
-    .$narrowType<{ title: Evolu.kysely.NotNull }>()
+    .$narrowType<{ title: Evolu.KyselyNotNull }>()
     // Columns createdAt, updatedAt, isDeleted are auto-added to all tables.
     .orderBy("createdAt"),
 );

examples/svelte-vite-pwa/package.json

@@ -16,7 +16,7 @@
     "@evolu/web": "workspace:*",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@tsconfig/svelte": "^5.0.8",
-    "svelte": "^5.53.7",
+    "svelte": "^5.53.10",
     "svelte-check": "^4.4.3",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",

examples/vue-vite-pwa/package.json

@@ -14,7 +14,7 @@
     "@evolu/common": "workspace:*",
     "@evolu/vue": "workspace:*",
     "@evolu/web": "workspace:*",
-    "vue": "^3.5.29",
+    "vue": "^3.5.30",
     "workbox-window": "^7.4.0"
   },
   "devDependencies": {

package.json

@@ -83,7 +83,7 @@
     "@vitest/browser-playwright": "^4.0.18",
     "@vitest/coverage-istanbul": "^4.0.18",
     "@vitest/coverage-v8": "^4.0.18",
-    "turbo": "^2.8.13",
+    "turbo": "^2.8.16",
     "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typescript": "^5.9.3",

packages/common/package.json

@@ -57,7 +57,7 @@
     "@noble/hashes": "^2.0.1",
     "@scure/bip39": "^2.0.1",
     "kysely": "^0.28.11",
-    "msgpackr": "^1.11.8",
+    "msgpackr": "^1.11.9",
     "zod": "^4.3.6"
   },
   "publishConfig": {
@@ -72,7 +72,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/ws": "^8.18.1",
     "better-sqlite3": "^12.6.2",
-    "fast-check": "^4.5.3",
+    "fast-check": "^4.6.0",
     "playwright": "^1.58.2",
     "typescript": "^5.9.3",
     "ws": "^8.19.0"

packages/common/src/Number.ts

@@ -105,7 +105,7 @@ export const computeBalancedBuckets = (
  */
 export const FibonacciIndex = /*#__PURE__*/ brand(
   "FibonacciIndex",
-  lessThanOrEqualTo(78)(PositiveInt),
+  /*#__PURE__*/ lessThanOrEqualTo(78)(PositiveInt),
 );
 export type FibonacciIndex = typeof FibonacciIndex.Type;
 

packages/common/src/Ref.ts

@@ -1,30 +1,26 @@
 /**
- * Mutable reference container for state management.
+ * Mutable reference.
  *
  * @module
  */
 
-import type { Eq } from "./Eq.js";
 import type { Store } from "./Store.js";
 
 /**
- * `Ref` provides a simple API to hold and update a value, similar to a "ref" in
- * functional programming or React. It exposes methods to get, set, and modify
- * the current state.
+ * Mutable reference.
  *
- * Use a Ref instead of a variable when you want to pass state around as an
- * object. If you need subscriptions, see {@link Store}.
+ * `Ref` holds a mutable value and exposes explicit `get`, `set`, `update`, and
+ * `modify` operations. Use it when mutable state needs to be passed around as a
+ * value.
  *
- * Ref is a valid dependency in Evolu's [Dependency
- * Injection](https://evolu.dev/docs/dependency-injection) pattern—use it when
- * functions need shared mutable state.
+ * For reactive state with subscriptions, see {@link Store}.
  *
  * ### Example
  *
  * ```ts
  * const count = createRef(0);
  * count.set(1);
- * count.modify((n) => n + 1);
+ * count.update((n) => n + 1);
  * console.log(count.get()); // 2
  * ```
  *
@@ -40,37 +36,71 @@ export interface Ref<T> {
   /** Returns the current state. */
   readonly get: () => T;
 
-  /** Sets the state. Returns `true` if the state was updated. */
-  readonly set: (state: T) => boolean;
+  /** Sets the state. */
+  readonly set: (state: T) => void;
 
-  /**
-   * Modifies the state using an updater function. Returns `true` if the state
-   * was updated.
-   */
-  readonly modify: (updater: (current: T) => T) => boolean;
+  /** Sets the state and returns the previous state. */
+  readonly getAndSet: (state: T) => T;
+
+  /** Sets the state and returns the current state after the update. */
+  readonly setAndGet: (state: T) => T;
+
+  /** Updates the state. */
+  readonly update: (updater: (current: T) => T) => void;
+
+  /** Updates the state and returns the previous state. */
+  readonly getAndUpdate: (updater: (current: T) => T) => T;
+
+  /** Updates the state and returns the current state after the update. */
+  readonly updateAndGet: (updater: (current: T) => T) => T;
+
+  /** Modifies the state and returns a computed result from the transition. */
+  readonly modify: <R>(
+    updater: (current: T) => readonly [result: R, nextState: T],
+  ) => R;
 }
 
-/**
- * Creates a {@link Ref} with the given initial state.
- *
- * By default, state is always updated. We can provide an optional {@link Eq}
- * function as the second argument to skip updates when the new state equals the
- * current state.
- */
-export const createRef = <T>(initialState: T, eq?: Eq<T>): Ref<T> => {
+/** Creates a {@link Ref} with the given initial state. */
+export const createRef = <T>(initialState: T): Ref<T> => {
   let currentState = initialState;
 
-  const updateState = (newState: T): boolean => {
-    if (eq?.(newState, currentState)) return false;
-    currentState = newState;
-    return true;
-  };
-
   return {
     get: () => currentState,
 
-    set: (state) => updateState(state),
+    set: (state) => {
+      currentState = state;
+    },
+
+    getAndSet: (state) => {
+      const previousState = currentState;
+      currentState = state;
+      return previousState;
+    },
+
+    setAndGet: (state) => {
+      currentState = state;
+      return currentState;
+    },
+
+    update: (updater) => {
+      currentState = updater(currentState);
+    },
+
+    getAndUpdate: (updater) => {
+      const previousState = currentState;
+      currentState = updater(currentState);
+      return previousState;
+    },
+
+    updateAndGet: (updater) => {
+      currentState = updater(currentState);
+      return currentState;
+    },
 
-    modify: (updater) => updateState(updater(currentState)),
+    modify: (updater) => {
+      const [result, nextState] = updater(currentState);
+      currentState = nextState;
+      return result;
+    },
   };
 };