Merge pull request #51 from SQLoot/sync/common-v8-2026-02-26

Sync/common v8 2026 02 26

Author: miccy

.changeset/sqlite-refactor.md

@@ -13,9 +13,11 @@ Refactored SQLite integration to use Task and throw-first semantics
 - Changed `Sqlite.exec` to return `SqliteExecResult` directly (no `Result<..., SqliteError>`)
 - Changed `Sqlite.transaction` to support callbacks returning either `Result<T, E>` or `void` (no `SqliteError` in the error channel)
 - Changed `Sqlite.export` to return `Uint8Array` directly (no `Result<..., SqliteError>`)
-- Simplified `SqliteDriver.exec` by removing the `isMutation` parameter — the driver now determines read vs write internally
+- Simplified `SqliteDriver.exec` by removing the `isMutation` parameter, so the driver determines read vs write internally
 - Replaced `options.memory` and `options.encryptionKey` with a discriminated `options.mode` field (`"memory"` | `"encrypted"`)
 - Updated Expo and op-sqlite drivers to match the new API
+- Added SQLite schema metadata primitives (`SqliteSchema`, `SqliteIndex`, `eqSqliteIndex`, `getSqliteSchema`, `getSqliteSnapshot`)
+- Added `testCreateRunWithSqlite` helper for SQLite tests
 
 Why `SqliteError` was removed:
 
@@ -29,7 +31,3 @@ Boundary handling:
 - At protocol boundaries (for example Protocol ↔ Storage), error handling remains explicit.
 - Since storage implementations may throw, boundary code uses `try/catch`, logs with `console.error(error)`, and returns protocol-level outcomes.
 - Protocol handles all thrown errors as boundary concerns, without coupling to SQLite-specific error types.
-
-Developer experience:
-
-- This change reduces boilerplate (`if (!result.ok)` branches and `SqliteError` plumbing), making infrastructure code less verbose and easier to follow.

bun.lock

@@ -4,7 +4,7 @@
   "repository": "https://github.com/SQLoot/evolu-plan-b",
   "author": "SQLoot",
   "license": "MIT",
-  "packageManager": "bun@1.3.9",
+  "packageManager": "bun@1.3.10",
   "workspaces": [
     "apps/*",
     "packages/*",
@@ -34,7 +34,7 @@
     "sync:guard:common-v8:strict": "bun ./scripts/sync-guard-common-v8.mts --strict",
     "verify:fast": "bun run build && bun run test && bun run lint && bun run lint-monorepo",
     "verify": "bun run format && bun run build && bun run test && bun run test:coverage && bun run lint && bun run lint-monorepo",
-    "clean": "turbo clean && rimraf node_modules bun.lock .turbo out",
+    "clean": "turbo clean && rimraf node_modules bun.lock .turbo out coverage",
     "version": "changeset version",
     "release": "bun run build && changeset publish",
     "ios": "cd examples/react-expo && bun ios",
@@ -57,7 +57,7 @@
     "@vitest/browser-playwright": "^4.0.18",
     "@vitest/coverage-v8": "^4.0.18",
     "rimraf": "^6.1.3",
-    "turbo": "^2.8.10",
+    "turbo": "^2.8.11",
     "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typescript": "^5.9.3",

package.json

@@ -1,12 +1,9 @@
 /**
- * Runtime platform detection utilities.
+ * Platform runtime utilities and capability abstractions.
  *
  * @module
  */
 
-import type { Task } from "./Task.js";
-import type { SimpleName } from "./Type.js";
-
 /** Returns true if running in React Native with Hermes engine. */
 export const isHermes = "HermesInternal" in globalThis;
 
@@ -49,26 +46,11 @@ export interface FlushSyncDep {
  * Use this after purging persistent storage to clear in-memory state and ensure
  * the app starts fresh. It does not purge storage itself.
  *
- * - **Web**: Redirects to the specified URL (defaults to `/`)
- * - **React Native**: Restarts the app (URL ignored)
+ * - Web: Redirects to the specified URL (defaults to `/`)
+ * - React Native: Restarts the app (URL ignored)
  */
 export type ReloadApp = (url?: string) => void;
 
 export interface ReloadAppDep {
   readonly reloadApp: ReloadApp;
 }
-
-/**
- * Cross-platform leader lock abstraction.
- *
- * `acquire` waits until leadership is acquired.
- *
- * Returns a {@link Disposable} lease. Dispose it to release leadership.
- */
-export interface LeaderLock {
-  readonly acquire: (name: SimpleName) => Task<Disposable>;
-}
-
-export interface LeaderLockDep {
-  readonly leaderLock: LeaderLock;
-}