Zero 1.8

Observability and Reliability

Installation

Copynpm install @rocicorp/zero@1.8

You can now use zero-cache from GHCR:

Copydocker pull rocicorp/zero:1.8.0
# or
docker pull ghcr.io/rocicorp/zero:1.8.0

Overview

Zero 1.8 improves observability, performance, and reliability.

Features

• Request-header forwarding: zero-cache can forward selected WebSocket upgrade headers to custom APIs using ZERO_MUTATE_ALLOWED_REQUEST_HEADERS and ZERO_QUERY_ALLOWED_REQUEST_HEADERS. (#6144, thanks @tjenkinson!)
• GHCR Docker images: Zero images are now published to ghcr.io/rocicorp/zero as well as Docker Hub. (#6161)
• Mutator result type: MutatorResult is now exported from @rocicorp/zero for typing helpers that await .client or .server. (#6223)
• Operational metrics: zero-cache adds metrics for API calls and startup, initial sync and replication slots, and Litestream backup and restore. (#6203, #6208, #6191, #6199, #6210)
• Stability metrics: New serving-lag, CVR, and WebSocket metrics and replication flow-control metrics help diagnose delayed updates, reconnects, and backpressure. (#6157, #6214, #6207, thanks @tantaman!)

Performance

Zero 1.8 speeds up local ZQL queries, ordered limit() queries, and replication after large Postgres writes.

Faster Local Queries

When a query first runs, Zero builds its view from data already synced to the client. For example, for the query:

Copyzql.issue
  .where('closed', false)
  .related('owner')
  .orderBy('createdAt', 'desc')

Zero 1.8 reduces the per-row work for common local scans, filters, and relationship lookups. Views like this can appear sooner and use less client CPU, with local query fetches running 1.57x to 2.36x faster, depending on the query.

Ordered limit() Queries

Consider a view showing the top 50 open issues:

Copyzql.issue
  .where('workspaceID', workspaceID)
  .where('status', 'open')
  .orderBy('priority', 'desc')
  .orderBy('created', 'asc')
  .limit(50)

If open issues are sparse, the 50th match can be deep in the ordered data. If an issue enters, leaves, or moves within the top 50, Zero reads around the current 50th issue to determine which issue belongs in the result next.

Zero 1.8 lets SQLite seek directly to that boundary instead of scanning earlier rows again. Boundary fetches are 1.09x faster after 50 rows and up to 300x faster at the end of a 100,000-row index.

Faster Replication After Bulk Writes

A bulk import, backfill, or migration can change tens of thousands of rows in one transaction. Zero records each change during replication, and writing them one at a time could make replication fall behind.

Zero 1.8 writes these changes in batches, making persistence 2.25x to 2.48x faster and helping large transactions reach clients sooner.

Fixes

• Logical replication now reconnects when the inbound Postgres stream goes silent.
• Postgres writes no longer use sockets after disconnection.
• The Drizzle adapter now handles array-mode results from Drizzle 1.0 RC prepareQuery. (thanks @typedrat!)
• z2s now compiles queries using start, and SQLite fetches handle null start-cursor fields.
• Queries no longer appear complete with stale or empty results after reconnect.
• React Native reads now work with op-sqlite v17.
• View-syncers no longer fail while the first backup is uploading or retry before a restorable backup exists on cold start.
• Zero Docker images now choose the correct default sync-worker count.
• Change-stream catch-up now respects flow control, preventing unbounded in-memory backlogs.

Breaking Changes

None.