Deps.

Remove singleflight.
Bump cross-platform-actions/action from 0.30.0 to 0.31.0
2026-01-19 17:14:15 +00:00 · 2025-12-19 12:28:57 +00:00 · 2025-12-17 13:17:50 +00:00 · 2025-12-16 12:34:55 +00:00 · 2025-12-12 17:21:33 +00:00 · 2025-12-12 13:06:37 +00:00
39 changed files with 971 additions and 655 deletions
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -98,12 +98,12 @@ jobs:
      matrix:
        os:
          - name: freebsd
-            version: '14.3'
+            version: '15.0'
          - name: netbsd
            version: '10.1'
          - name: freebsd
            arch: arm64
-            version: '14.3'
+            version: '15.0'
            tflags: '-test.short'
          - name: netbsd
            arch: arm64
@@ -126,7 +126,7 @@ jobs:
      run: .github/workflows/build-test.sh

    - name: Test
-      uses: cross-platform-actions/action@v0.30.0
+      uses: cross-platform-actions/action@v0.31.0
      with:
        operating_system: ${{ matrix.os.name }}
        architecture: ${{ matrix.os.arch }}
--- a/driver/driver.go
+++ b/driver/driver.go
@@ -440,22 +440,6 @@ func (c *conn) CheckNamedValue(arg *driver.NamedValue) error {
 	return nil
 }

-// Deprecated: for Litestream use only; may be removed at any time.
-func (c *conn) FileControlPersistWAL(schema string, mode int) (int, error) {
-	// notest
-	arg := make([]any, 1)
-	if mode >= 0 {
-		arg[0] = mode > 0
-	} else {
-		arg = arg[:0]
-	}
-	res, err := c.Conn.FileControl(schema, sqlite3.FCNTL_PERSIST_WAL, arg...)
-	if res == true {
-		return 1, err
-	}
-	return 0, err
-}
-
 type stmt struct {
 	*sqlite3.Stmt
 	tmWrite sqlite3.TimeFormat
@@ -669,14 +653,12 @@ type rows struct {
 	names []string
 	types []string
 	scans []scantype
-	dest  []driver.Value
 }

 var (
 	// Ensure these interfaces are implemented:
 	_ driver.RowsColumnTypeDatabaseTypeName = &rows{}
 	_ driver.RowsColumnTypeNullable         = &rows{}
-	// _ driver.RowsColumnScanner           = &rows{}
 )

 func (r *rows) Close() error {
@@ -796,7 +778,6 @@ func (r *rows) ColumnTypeScanType(index int) (typ reflect.Type) {
 }

 func (r *rows) Next(dest []driver.Value) error {
-	r.dest = nil
 	c := r.Stmt.Conn()
 	if old := c.SetInterrupt(r.ctx); old != r.ctx {
 		defer c.SetInterrupt(old)
@@ -846,33 +827,5 @@ func (r *rows) Next(dest []driver.Value) error {
 			}
 		}
 	}
-	r.dest = dest
 	return nil
 }
-
-func (r *rows) ScanColumn(dest any, index int) (err error) {
-	// notest // Go 1.26
-	var tm *time.Time
-	var ok *bool
-	switch d := dest.(type) {
-	case *time.Time:
-		tm = d
-	case *sql.NullTime:
-		tm = &d.Time
-		ok = &d.Valid
-	case *sql.Null[time.Time]:
-		tm = &d.V
-		ok = &d.Valid
-	default:
-		return driver.ErrSkip
-	}
-	value := r.dest[index]
-	*tm, err = r.tmRead.Decode(value)
-	if ok != nil {
-		*ok = err == nil
-		if value == nil {
-			return nil
-		}
-	}
-	return err
-}
--- a/driver/driver_test.go
+++ b/driver/driver_test.go
@@ -8,7 +8,6 @@ import (
 	"math"
 	"net/url"
 	"reflect"
-	"strings"
 	"testing"
 	"time"

@@ -521,39 +520,6 @@ func Test_ColumnType_ScanType(t *testing.T) {
 	}
 }

-func Test_rows_ScanColumn(t *testing.T) {
-	t.Parallel()
-	dsn := memdb.TestDB(t)
-
-	db, err := Open(dsn)
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer db.Close()
-
-	var tm time.Time
-	err = db.QueryRow(`SELECT NULL`).Scan(&tm)
-	if err == nil {
-		t.Error("want error")
-	}
-	// Go 1.26
-	err = db.QueryRow(`SELECT datetime()`).Scan(&tm)
-	if err != nil && !strings.HasPrefix(err.Error(), "sql: Scan error") {
-		t.Error(err)
-	}
-
-	var nt sql.NullTime
-	err = db.QueryRow(`SELECT NULL`).Scan(&nt)
-	if err != nil {
-		t.Error(err)
-	}
-	// Go 1.26
-	err = db.QueryRow(`SELECT datetime()`).Scan(&nt)
-	if err != nil && !strings.HasPrefix(err.Error(), "sql: Scan error") {
-		t.Error(err)
-	}
-}
-
 func Benchmark_loop(b *testing.B) {
 	db, err := Open(":memory:")
 	if err != nil {
--- a/embed/README.md
+++ b/embed/README.md
@@ -1,6 +1,6 @@
 # Embeddable Wasm build of SQLite

-This folder includes an embeddable Wasm build of SQLite 3.50.4 for use with
+This folder includes an embeddable Wasm build of SQLite 3.51.1 for use with
 [`github.com/ncruces/go-sqlite3`](https://pkg.go.dev/github.com/ncruces/go-sqlite3).

 The following optional features are compiled in:
--- a/embed/bcw2/bcw2.wasm
+++ b/embed/bcw2/bcw2.wasm
--- a/embed/bcw2/build.sh
+++ b/embed/bcw2/build.sh
@@ -15,14 +15,15 @@ cp "$ROOT"/sqlite3/*.[ch] build/
 cp "$ROOT"/sqlite3/*.patch build/
 cd sqlite/

-# https://sqlite.org/src/info/352b363a5d727047
-curl -#L https://github.com/sqlite/sqlite/archive/dbd613c.tar.gz | tar xz --strip-components=1
-# curl -#L https://sqlite.org/src/tarball/sqlite.tar.gz?r=352b363a5d | tar xz --strip-components=1
+# https://sqlite.org/src/info/f273f6b8245c5dca
+curl -#L https://github.com/sqlite/sqlite/archive/7c126d7.tar.gz | tar xz --strip-components=1
+# curl -#L https://sqlite.org/src/tarball/sqlite.tar.gz?r=f273f6b824 | tar xz --strip-components=1

 if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" ]]; then
 	MSYS_NO_PATHCONV=1 nmake /f makefile.msc sqlite3.c "OPTS=-DSQLITE_ENABLE_UPDATE_DELETE_LIMIT -DSQLITE_ENABLE_ORDERED_SET_AGGREGATES"
 else
 	sh configure --enable-update-limit
+	make verify-source
 	OPTS=-DSQLITE_ENABLE_ORDERED_SET_AGGREGATES make sqlite3.c
 fi
 cd ~-
--- a/embed/bcw2/go.mod
+++ b/embed/bcw2/go.mod
@@ -2,11 +2,11 @@ module github.com/ncruces/go-sqlite3/embed/bcw2

 go 1.24.0

-require github.com/ncruces/go-sqlite3 v0.30.1
+require github.com/ncruces/go-sqlite3 v0.30.3

 require (
 	github.com/ncruces/julianday v1.0.0 // indirect
 	github.com/ncruces/sort v0.1.6 // indirect
-	github.com/tetratelabs/wazero v1.10.1 // indirect
-	golang.org/x/sys v0.38.0 // indirect
+	github.com/tetratelabs/wazero v1.11.0 // indirect
+	golang.org/x/sys v0.39.0 // indirect
 )
--- a/embed/bcw2/go.sum
+++ b/embed/bcw2/go.sum
@@ -1,12 +1,12 @@
-github.com/ncruces/go-sqlite3 v0.30.1 h1:pHC3YsyRdJv4pCMB4MO1Q2BXw/CAa+Hoj7GSaKtVk+g=
-github.com/ncruces/go-sqlite3 v0.30.1/go.mod h1:UVsWrQaq1qkcal5/vT5lOJnZCVlR5rsThKdwidjFsKc=
+github.com/ncruces/go-sqlite3 v0.30.3 h1:X/CgWW9GzmIAkEPrifhKqf0cC15DuOVxAJaHFTTAURQ=
+github.com/ncruces/go-sqlite3 v0.30.3/go.mod h1:AxKu9sRxkludimFocbktlY6LiYSkxiI5gTA8r+os/Nw=
 github.com/ncruces/julianday v1.0.0 h1:fH0OKwa7NWvniGQtxdJRxAgkBMolni2BjDHaWTxqt7M=
 github.com/ncruces/julianday v1.0.0/go.mod h1:Dusn2KvZrrovOMJuOt0TNXL6tB7U2E8kvza5fFc9G7g=
 github.com/ncruces/sort v0.1.6 h1:TrsJfGRH1AoWoaeB4/+gCohot9+cA6u/INaH5agIhNk=
 github.com/ncruces/sort v0.1.6/go.mod h1:obJToO4rYr6VWP0Uw5FYymgYGt3Br4RXcs/JdKaXAPk=
-github.com/tetratelabs/wazero v1.10.1 h1:2DugeJf6VVk58KTPszlNfeeN8AhhpwcZqkJj2wwFuH8=
-github.com/tetratelabs/wazero v1.10.1/go.mod h1:DRm5twOQ5Gr1AoEdSi0CLjDQF1J9ZAuyqFIjl1KKfQU=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/text v0.30.0 h1:yznKA/E9zq54KzlzBEAWn1NXSQ8DIp/NYMy88xJjl4k=
-golang.org/x/text v0.30.0/go.mod h1:yDdHFIX9t+tORqspjENWgzaCVXgk0yYnYuSZ8UzzBVM=
+github.com/tetratelabs/wazero v1.11.0 h1:+gKemEuKCTevU4d7ZTzlsvgd1uaToIDtlQlmNbwqYhA=
+github.com/tetratelabs/wazero v1.11.0/go.mod h1:eV28rsN8Q+xwjogd7f4/Pp4xFxO7uOGbLcD/LzB1wiU=
+golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
+golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
+golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
--- a/embed/build.sh
+++ b/embed/build.sh
@@ -23,6 +23,7 @@ trap 'rm -f sqlite3.tmp' EXIT
 	-Wl,--import-undefined \
 	-Wl,--initial-memory=327680 \
 	-D_HAVE_SQLITE_CONFIG_H \
+	-DSQLITE_EXPERIMENTAL_PRAGMA_20251114 \
 	-DSQLITE_CUSTOM_INCLUDE=sqlite_opt.h \
 	$(awk '{print "-Wl,--export="$0}' exports.txt)

--- a/embed/init_test.go
+++ b/embed/init_test.go
@@ -19,7 +19,7 @@ func Test_init(t *testing.T) {
 	if err != nil {
 		t.Fatal(err)
 	}
-	if version != "3.51.0" {
+	if version != "3.51.1" {
 		t.Error(version)
 	}
 }
--- a/embed/sqlite3.wasm
+++ b/embed/sqlite3.wasm
--- a/ext/bloom/bloom.go
+++ b/ext/bloom/bloom.go
@@ -16,6 +16,7 @@ import (

 	"github.com/ncruces/go-sqlite3"
 	"github.com/ncruces/go-sqlite3/internal/util"
+	"github.com/ncruces/go-sqlite3/util/sql3util"
 )

 // Register registers the bloom_filter virtual table:
@@ -55,11 +56,9 @@ func create(db *sqlite3.Conn, _, schema, table string, arg ...string) (_ *bloom,
 	}

 	if len(arg) > 1 {
-		b.prob, err = strconv.ParseFloat(arg[1], 64)
-		if err != nil {
-			return nil, err
-		}
-		if b.prob <= 0 || b.prob >= 1 {
+		var ok bool
+		b.prob, ok = sql3util.ParseFloat(arg[1])
+		if !ok || b.prob <= 0 || b.prob >= 1 {
 			return nil, util.ErrorString("bloom: probability must be in the range (0,1)")
 		}
 	} else {
--- a/ext/csv/csv.go
+++ b/ext/csv/csv.go
@@ -254,19 +254,15 @@ func (c *cursor) Column(ctx sqlite3.Context, col int) error {

 		switch typ {
 		case numeric, integer:
-			if strings.TrimLeft(txt, "+-0123456789") == "" {
-				if i, err := strconv.ParseInt(txt, 10, 64); err == nil {
-					ctx.ResultInt64(i)
-					return nil
-				}
+			if i, err := strconv.ParseInt(txt, 10, 64); err == nil {
+				ctx.ResultInt64(i)
+				return nil
 			}
 			fallthrough
 		case real:
-			if strings.TrimLeft(txt, "+-.0123456789Ee") == "" {
-				if f, err := strconv.ParseFloat(txt, 64); err == nil {
-					ctx.ResultFloat(f)
-					return nil
-				}
+			if f, ok := sql3util.ParseFloat(txt); ok {
+				ctx.ResultFloat(f)
+				return nil
 			}
 			fallthrough
 		default:
--- a/go.mod
+++ b/go.mod
@@ -6,17 +6,17 @@ require (
 	github.com/ncruces/julianday v1.0.0
 	github.com/ncruces/sort v0.1.6
 	github.com/ncruces/wbt v0.2.0
-	github.com/tetratelabs/wazero v1.10.1
-	golang.org/x/sys v0.38.0
+	github.com/tetratelabs/wazero v1.11.0
+	golang.org/x/sys v0.39.0
 )

 require (
 	github.com/dchest/siphash v1.2.3 // ext/bloom
 	github.com/google/uuid v1.6.0 // ext/uuid
 	github.com/psanford/httpreadat v0.1.0 // example
-	golang.org/x/crypto v0.45.0 // vfs/adiantum vfs/xts
-	golang.org/x/sync v0.18.0 // test
-	golang.org/x/text v0.31.0 // ext/unicode
+	golang.org/x/crypto v0.46.0 // vfs/adiantum vfs/xts
+	golang.org/x/sync v0.19.0 // test
+	golang.org/x/text v0.32.0 // ext/unicode
 	lukechampine.com/adiantum v1.1.1 // vfs/adiantum
 )

--- a/go.sum
+++ b/go.sum
@@ -10,15 +10,15 @@ github.com/ncruces/wbt v0.2.0 h1:Q9zlKOBSZc7Yy/R2cGa35g6RKUUE3BjNIW3tfGC4F04=
 github.com/ncruces/wbt v0.2.0/go.mod h1:DtF92amvMxH69EmBFUSFWRDAlo6hOEfoNQnClxj9C/c=
 github.com/psanford/httpreadat v0.1.0 h1:VleW1HS2zO7/4c7c7zNl33fO6oYACSagjJIyMIwZLUE=
 github.com/psanford/httpreadat v0.1.0/go.mod h1:Zg7P+TlBm3bYbyHTKv/EdtSJZn3qwbPwpfZ/I9GKCRE=
-github.com/tetratelabs/wazero v1.10.1 h1:2DugeJf6VVk58KTPszlNfeeN8AhhpwcZqkJj2wwFuH8=
-github.com/tetratelabs/wazero v1.10.1/go.mod h1:DRm5twOQ5Gr1AoEdSi0CLjDQF1J9ZAuyqFIjl1KKfQU=
-golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q=
-golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4=
-golang.org/x/sync v0.18.0 h1:kr88TuHDroi+UVf+0hZnirlk8o8T+4MrK6mr60WkH/I=
-golang.org/x/sync v0.18.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
-golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
+github.com/tetratelabs/wazero v1.11.0 h1:+gKemEuKCTevU4d7ZTzlsvgd1uaToIDtlQlmNbwqYhA=
+github.com/tetratelabs/wazero v1.11.0/go.mod h1:eV28rsN8Q+xwjogd7f4/Pp4xFxO7uOGbLcD/LzB1wiU=
+golang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU=
+golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0=
+golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
+golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
+golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=
+golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
 lukechampine.com/adiantum v1.1.1 h1:4fp6gTxWCqpEbLy40ExiYDDED3oUNWx5cTqBCtPdZqA=
 lukechampine.com/adiantum v1.1.1/go.mod h1:LrAYVnTYLnUtE/yMp5bQr0HstAf060YUF8nM0B6+rUw=
--- a/gormlite/go.mod
+++ b/gormlite/go.mod
@@ -3,7 +3,7 @@ module github.com/ncruces/go-sqlite3/gormlite
 go 1.24.0

 require (
-	github.com/ncruces/go-sqlite3 v0.30.1
+	github.com/ncruces/go-sqlite3 v0.30.3
 	gorm.io/gorm v1.31.1
 )

@@ -11,7 +11,7 @@ require (
 	github.com/jinzhu/inflection v1.0.0 // indirect
 	github.com/jinzhu/now v1.1.5 // indirect
 	github.com/ncruces/julianday v1.0.0 // indirect
-	github.com/tetratelabs/wazero v1.10.1 // indirect
-	golang.org/x/sys v0.38.0 // indirect
-	golang.org/x/text v0.31.0 // indirect
+	github.com/tetratelabs/wazero v1.11.0 // indirect
+	golang.org/x/sys v0.39.0 // indirect
+	golang.org/x/text v0.32.0 // indirect
 )
--- a/gormlite/go.sum
+++ b/gormlite/go.sum
@@ -2,15 +2,15 @@ github.com/jinzhu/inflection v1.0.0 h1:K317FqzuhWc8YvSVlFMCCUb36O/S9MCKRDI7QkRKD
 github.com/jinzhu/inflection v1.0.0/go.mod h1:h+uFLlag+Qp1Va5pdKtLDYj+kHp5pxUVkryuEj+Srlc=
 github.com/jinzhu/now v1.1.5 h1:/o9tlHleP7gOFmsnYNz3RGnqzefHA47wQpKrrdTIwXQ=
 github.com/jinzhu/now v1.1.5/go.mod h1:d3SSVoowX0Lcu0IBviAWJpolVfI5UJVZZ7cO71lE/z8=
-github.com/ncruces/go-sqlite3 v0.30.1 h1:pHC3YsyRdJv4pCMB4MO1Q2BXw/CAa+Hoj7GSaKtVk+g=
-github.com/ncruces/go-sqlite3 v0.30.1/go.mod h1:UVsWrQaq1qkcal5/vT5lOJnZCVlR5rsThKdwidjFsKc=
+github.com/ncruces/go-sqlite3 v0.30.3 h1:X/CgWW9GzmIAkEPrifhKqf0cC15DuOVxAJaHFTTAURQ=
+github.com/ncruces/go-sqlite3 v0.30.3/go.mod h1:AxKu9sRxkludimFocbktlY6LiYSkxiI5gTA8r+os/Nw=
 github.com/ncruces/julianday v1.0.0 h1:fH0OKwa7NWvniGQtxdJRxAgkBMolni2BjDHaWTxqt7M=
 github.com/ncruces/julianday v1.0.0/go.mod h1:Dusn2KvZrrovOMJuOt0TNXL6tB7U2E8kvza5fFc9G7g=
-github.com/tetratelabs/wazero v1.10.1 h1:2DugeJf6VVk58KTPszlNfeeN8AhhpwcZqkJj2wwFuH8=
-github.com/tetratelabs/wazero v1.10.1/go.mod h1:DRm5twOQ5Gr1AoEdSi0CLjDQF1J9ZAuyqFIjl1KKfQU=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
-golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
+github.com/tetratelabs/wazero v1.11.0 h1:+gKemEuKCTevU4d7ZTzlsvgd1uaToIDtlQlmNbwqYhA=
+github.com/tetratelabs/wazero v1.11.0/go.mod h1:eV28rsN8Q+xwjogd7f4/Pp4xFxO7uOGbLcD/LzB1wiU=
+golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
+golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=
+golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
 gorm.io/gorm v1.31.1 h1:7CA8FTFz/gRfgqgpeKIBcervUn3xSyPUmr6B2WXJ7kg=
 gorm.io/gorm v1.31.1/go.mod h1:XyQVbO2k6YkOis7C2437jSit3SsDK72s7n7rsSHd+Gs=
--- a/litestream/README.md
+++ b/litestream/README.md
@@ -1,27 +1,11 @@
-# Litestream in-process replication and lightweight read-replicas
+# Litestream lightweight read-replicas

-This package adds **EXPERIMENTAL** support for in-process [Litestream](https://litestream.io/).
-
-## Lightweight read-replicas
-
-The `"litestream"` SQLite VFS implements Litestream
-[lightweight read-replicas](https://fly.io/blog/litestream-revamped/#lightweight-read-replicas).
+This package implements the **EXPERIMENTAL** `"litestream"` SQLite VFS
+that offers Litestream [lightweight read-replicas](https://fly.io/blog/litestream-revamped/#lightweight-read-replicas).

 See the [example](example_test.go) for how to use.

-To improve performance,
-increase `PollInterval` (and `MinLevel`) as much as you can,
-and set [`PRAGMA cache_size=N`](https://www.sqlite.org/pragma.html#pragma_cache_size)
-(or use `_pragma=cache_size(N)`).
-
-## In-process replication
-
-For disaster recovery, it is probably best if you run Litestream as a separate background process,
-as recommended by the [tutorial](https://litestream.io/getting-started/).
-
-However, running Litestream as a background process requires
-compatible locking and cross-process shared memory WAL
-(see our [support matrix](https://github.com/ncruces/go-sqlite3/wiki/Support-matrix)).
-
-If your OS lacks locking or shared memory support,
-you can use `NewPrimary` with the `sqlite3_dotlk` build tag to setup in-process replication.
+Our `PRAGMA litestream_time` accepts:
+- Go [duration strings](https://pkg.go.dev/time#ParseDuration)
+- SQLite [time values](https://sqlite.org/lang_datefunc.html#time_values)
+- SQLite [time modifiers 1 through 13](https://sqlite.org/lang_datefunc.html#modifiers)
--- a/litestream/api.go
+++ b/litestream/api.go
@@ -2,7 +2,6 @@
 package litestream

 import (
-	"context"
 	"log/slog"
 	"sync"
 	"time"
@@ -40,16 +39,13 @@ type ReplicaOptions struct {
 	// used by the replica at MinLevel+1.
 	PollInterval time.Duration

-	// Minimum compaction level to track.
-	MinLevel int
-
 	// CacheSize is the maximum size of the page cache in bytes.
 	// Zero means DefaultCacheSize, negative disables caching.
 	CacheSize int
 }

 // NewReplica creates a read-replica from a Litestream client.
-func NewReplica(name string, client litestream.ReplicaClient, options ReplicaOptions) {
+func NewReplica(name string, client ReplicaClient, options ReplicaOptions) {
 	if options.Logger != nil {
 		options.Logger = options.Logger.With("name", name)
 	} else {
@@ -78,22 +74,4 @@ func RemoveReplica(name string) {
 	delete(liteDBs, name)
 }

-// NewPrimary creates a new primary that replicates through a client.
-// If restore is not nil, the database is first restored.
-func NewPrimary(ctx context.Context, path string, client litestream.ReplicaClient, restore *litestream.RestoreOptions) (*litestream.DB, error) {
-	lsdb := litestream.NewDB(path)
-	lsdb.Replica = litestream.NewReplicaWithClient(lsdb, client)
-
-	if restore != nil {
-		err := lsdb.Replica.Restore(ctx, *restore)
-		if err != nil {
-			return nil, err
-		}
-	}
-
-	err := lsdb.Open()
-	if err != nil {
-		return nil, err
-	}
-	return lsdb, nil
-}
+type ReplicaClient = litestream.ReplicaClient
--- a/litestream/cache.go
+++ b/litestream/cache.go
@@ -1,19 +1,18 @@
 package litestream

 import (
-	"encoding/binary"
+	"context"
+	"fmt"
 	"sync"

-	"golang.org/x/sync/singleflight"
-
+	"github.com/benbjohnson/litestream"
 	"github.com/superfly/ltx"
 )

 type pageCache struct {
-	single singleflight.Group
-	pages  map[uint32]cachedPage // +checklocks:mtx
-	size   int
-	mtx    sync.Mutex
+	pages map[uint32]cachedPage // +checklocks:mtx
+	size  int
+	mtx   sync.Mutex
 }

 type cachedPage struct {
@@ -21,37 +20,36 @@ type cachedPage struct {
 	txid ltx.TXID
 }

-func (c *pageCache) getOrFetch(pgno uint32, maxTXID ltx.TXID, fetch func() (any, error)) ([]byte, error) {
-	if c.size >= 0 {
+func (c *pageCache) getOrFetch(ctx context.Context, client ReplicaClient, pgno uint32, elem ltx.PageIndexElem) ([]byte, error) {
+	if c.size > 0 {
 		c.mtx.Lock()
-		if c.pages == nil {
-			c.pages = map[uint32]cachedPage{}
-		}
 		page := c.pages[pgno]
 		c.mtx.Unlock()

-		if page.txid == maxTXID {
+		if page.txid == elem.MaxTXID {
 			return page.data, nil
 		}
 	}

-	var key [12]byte
-	binary.LittleEndian.PutUint32(key[0:], pgno)
-	binary.LittleEndian.PutUint64(key[4:], uint64(maxTXID))
-	v, err, _ := c.single.Do(string(key[:]), fetch)
-
+	h, data, err := litestream.FetchPage(ctx, client, elem.Level, elem.MinTXID, elem.MaxTXID, elem.Offset, elem.Size)
 	if err != nil {
-		return nil, err
+		return nil, fmt.Errorf("fetch page: %w", err)
+	}
+	if pgno != h.Pgno {
+		return nil, fmt.Errorf("fetch page: want %d, got %d", pgno, h.Pgno)
 	}

-	page := cachedPage{v.([]byte), maxTXID}
-	if c.size >= 0 {
+	if c.size > 0 {
 		c.mtx.Lock()
-		c.evict(len(page.data))
-		c.pages[pgno] = page
+		if c.pages != nil {
+			c.evict(len(data))
+		} else {
+			c.pages = map[uint32]cachedPage{}
+		}
+		c.pages[pgno] = cachedPage{data, elem.MaxTXID}
 		c.mtx.Unlock()
 	}
-	return page.data, nil
+	return data, nil
 }

 // +checklocks:c.mtx
--- a/litestream/go.mod
+++ b/litestream/go.mod
@@ -3,18 +3,17 @@ module github.com/ncruces/go-sqlite3/litestream
 go 1.24.4

 require (
-	github.com/benbjohnson/litestream v0.5.2
-	github.com/ncruces/go-sqlite3 v0.30.1
+	github.com/benbjohnson/litestream v0.5.5
+	github.com/ncruces/go-sqlite3 v0.30.4-0.20251216123455-0b46e74ea69b
 	github.com/ncruces/wbt v0.2.0
-	github.com/superfly/ltx v0.5.0
-	golang.org/x/sync v0.18.0
+	github.com/superfly/ltx v0.5.1
 )

 // github.com/ncruces/go-sqlite3
 require (
 	github.com/ncruces/julianday v1.0.0 // indirect
-	github.com/tetratelabs/wazero v1.10.1 // indirect
-	golang.org/x/sys v0.38.0 // indirect
+	github.com/tetratelabs/wazero v1.11.0 // indirect
+	golang.org/x/sys v0.39.0 // indirect
 )

 // github.com/superfly/ltx
@@ -22,20 +21,19 @@ require github.com/pierrec/lz4/v4 v4.1.22 // indirect

 // github.com/benbjohnson/litestream
 require (
-	filippo.io/age v1.2.1 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
 	github.com/kr/text v0.2.0 // indirect
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
+	github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
 	github.com/prometheus/client_golang v1.23.2 // indirect
 	github.com/prometheus/client_model v0.6.2 // indirect
 	github.com/prometheus/common v0.67.4 // indirect
 	github.com/prometheus/procfs v0.19.2 // indirect
-	github.com/psanford/sqlite3vfs v0.0.0-20240315230605-24e1d98cf361 // indirect
+	github.com/rogpeppe/go-internal v1.12.0 // indirect
 	go.yaml.in/yaml/v2 v2.4.3 // indirect
-	golang.org/x/crypto v0.45.0 // indirect
-	google.golang.org/protobuf v1.36.10 // indirect
-	modernc.org/sqlite v1.40.1 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
 )

 // github.com/benbjohnson/litestream/s3
@@ -61,4 +59,4 @@ require (
 	github.com/aws/smithy-go v1.22.5 // indirect
 )

-replace modernc.org/sqlite => github.com/ncruces/go-sqlite3/litestream/modernc v0.30.1
+replace github.com/benbjohnson/litestream => github.com/ncruces/litestream v0.5.5
--- a/litestream/go.sum
+++ b/litestream/go.sum
@@ -1,7 +1,5 @@
-c2sp.org/CCTV/age v0.0.0-20240306222714-3ec4d716e805 h1:u2qwJeEvnypw+OCPUHmoZE3IqwfuN5kgDfo5MLzpNM0=
-c2sp.org/CCTV/age v0.0.0-20240306222714-3ec4d716e805/go.mod h1:FomMrUJ2Lxt5jCLmZkG3FHa72zUprnhd3v/Z18Snm4w=
-cloud.google.com/go v0.111.0 h1:YHLKNupSD1KqjDbQ3+LVdQ81h/UJbJyZG203cEfnQgM=
-cloud.google.com/go v0.111.0/go.mod h1:0mibmpKP1TyOOFYQY5izo0LnT+ecvOQ0Sg3OdmMiNRU=
+cloud.google.com/go v0.110.10 h1:LXy9GEO+timppncPIAZoOj3l58LIU9k+kn48AN7IO3Y=
+cloud.google.com/go v0.110.10/go.mod h1:v1OoFqYxiBkUrruItNM3eT4lLByNjxmJSV/xDKJNnic=
 cloud.google.com/go/compute v1.23.3 h1:6sVlXXBmbd7jNX0Ipq0trII3e4n1/MsADLK6a+aiVlk=
 cloud.google.com/go/compute v1.23.3/go.mod h1:VCgBUoMnIVIR0CscqQiPJLAG25E3ZRZMzcFZeQ+h8CI=
 cloud.google.com/go/compute/metadata v0.2.3 h1:mg4jlk7mCAj6xXp9UJ4fjI9VUI5rubuGBW5aJ7UnBMY=
@@ -10,8 +8,6 @@ cloud.google.com/go/iam v1.1.5 h1:1jTsCu4bcsNsE4iiqNT5SHwrDRCfRmIaaaVFhRveTJI=
 cloud.google.com/go/iam v1.1.5/go.mod h1:rB6P/Ic3mykPbFio+vo7403drjlgvoWfYpJhMXEbzv8=
 cloud.google.com/go/storage v1.36.0 h1:P0mOkAcaJxhCTvAkMhxMfrTKiNcub4YmmPBtlhAyTr8=
 cloud.google.com/go/storage v1.36.0/go.mod h1:M6M/3V/D3KpzMTJyPOR/HU6n2Si5QdaXYEsng2xgOs8=
-filippo.io/age v1.2.1 h1:X0TZjehAZylOIj4DubWYU1vWQxv9bJpo+Uu2/LGhi1o=
-filippo.io/age v1.2.1/go.mod h1:JL9ew2lTN+Pyft4RiNGguFfOpewKwSHm5ayKD/A4004=
 github.com/Azure/azure-sdk-for-go/sdk/azcore v1.18.2 h1:Hr5FTipp7SL07o2FvoVOX9HRiRH3CR3Mj8pxqCcdD5A=
 github.com/Azure/azure-sdk-for-go/sdk/azcore v1.18.2/go.mod h1:QyVsSSN64v5TGltphKLQ2sQxe4OBQg0J1eKRcVBnfgE=
 github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.11.0 h1:MhRfI58HblXzCtWEZCO0feHs8LweePB3s90r7WaR1KU=
@@ -22,6 +18,8 @@ github.com/Azure/azure-sdk-for-go/sdk/storage/azblob v1.6.2 h1:FwladfywkNirM+FZY
 github.com/Azure/azure-sdk-for-go/sdk/storage/azblob v1.6.2/go.mod h1:vv5Ad0RrIoT1lJFdWBZwt4mB1+j+V8DUroixmKDTCdk=
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2 h1:oygO0locgZJe7PpYPXT5A29ZkwJaPqcva7BVeemZOZs=
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2/go.mod h1:wP83P5OoQ5p6ip3ScPr0BAq0BvuPAvacpEuSzyouqAI=
+github.com/aliyun/alibabacloud-oss-go-sdk-v2 v1.3.0 h1:wQlqotpyjYPjJz+Noh5bRu7Snmydk8SKC5Z6u1CR20Y=
+github.com/aliyun/alibabacloud-oss-go-sdk-v2 v1.3.0/go.mod h1:FTzydeQVmR24FI0D6XWUOMKckjXehM/jgMn1xC+DA9M=
 github.com/aws/aws-sdk-go-v2 v1.37.1 h1:SMUxeNz3Z6nqGsXv0JuJXc8w5YMtrQMuIBmDx//bBDY=
 github.com/aws/aws-sdk-go-v2 v1.37.1/go.mod h1:9Q0OoGQoboYIAJyslFyF1f5K1Ryddop8gqMhWx/n4Wg=
 github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.0 h1:6GMWV6CNpA/6fbFHnoAjrv4+LGfyTqZz2LtCHnspgDg=
@@ -60,15 +58,13 @@ github.com/aws/aws-sdk-go-v2/service/sts v1.35.1 h1:iF4Xxkc0H9c/K2dS0zZw3SCkj0Z7
 github.com/aws/aws-sdk-go-v2/service/sts v1.35.1/go.mod h1:0bxIatfN0aLq4mjoLDeBpOjOke68OsFlXPDFJ7V0MYw=
 github.com/aws/smithy-go v1.22.5 h1:P9ATCXPMb2mPjYBgueqJNCA5S9UfktsW0tTxi+a7eqw=
 github.com/aws/smithy-go v1.22.5/go.mod h1:t1ufH5HMublsJYulve2RKmHDC15xu1f26kHCp/HgceI=
-github.com/benbjohnson/litestream v0.5.2 h1:uD9I17n6RgUgyCwPM/Sw2YXNmMGixecUB5kmJ4FL08o=
-github.com/benbjohnson/litestream v0.5.2/go.mod h1:jSW6AGqbxmJnEXGjMHchlZclGphzbJ6jGrGo5fYIDhU=
 github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
 github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
 github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
 github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
+github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=
 github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U=
 github.com/go-logr/logr v1.3.0 h1:2y3SDp0ZXuc6/cjLSZ+Q3ir+QB9T/iG5yYRXqsagWSY=
@@ -81,7 +77,6 @@ github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da h1:oI5xCqsCo564l
 github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
 github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg=
 github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=
-github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/s2a-go v0.1.7 h1:60BLSyTrOV4/haCDW4zb1guZItoSq8foHCXrAnjBo/o=
@@ -102,9 +97,6 @@ github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc=
 github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw=
-github.com/mattn/go-sqlite3 v1.14.8/go.mod h1:NyWgC/yNuGj7Q9rpYnZvas74GogHl5/Z4A/KQRfk6bU=
-github.com/mattn/go-sqlite3 v1.14.19 h1:fhGleo2h1p8tVChob4I9HpmVFIAkKGpiukdrgQbWfGI=
-github.com/mattn/go-sqlite3 v1.14.19/go.mod h1:2eHXhiwb8IkHr+BDWZGa96P6+rkvnG63S2DGjv9HUNg=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
 github.com/nats-io/nats.go v1.44.0 h1:ECKVrDLdh/kDPV1g0gAQ+2+m2KprqZK5O/eJAyAnH2M=
@@ -113,12 +105,12 @@ github.com/nats-io/nkeys v0.4.11 h1:q44qGV008kYd9W1b1nEBkNzvnWxtRSQ7A8BoqRrcfa0=
 github.com/nats-io/nkeys v0.4.11/go.mod h1:szDimtgmfOi9n25JpfIdGw12tZFYXqhGxjhVxsatHVE=
 github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
 github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
-github.com/ncruces/go-sqlite3 v0.30.1 h1:pHC3YsyRdJv4pCMB4MO1Q2BXw/CAa+Hoj7GSaKtVk+g=
-github.com/ncruces/go-sqlite3 v0.30.1/go.mod h1:UVsWrQaq1qkcal5/vT5lOJnZCVlR5rsThKdwidjFsKc=
-github.com/ncruces/go-sqlite3/litestream/modernc v0.30.1 h1:3SNAOrm+qmLprkZybcvBrVNHyt0QYHljUGxmOXnL+K0=
-github.com/ncruces/go-sqlite3/litestream/modernc v0.30.1/go.mod h1:GSM2gXEOb9HIFFtsl0IUtnpvpDmVi7Kbp8z5GzwA0Tw=
+github.com/ncruces/go-sqlite3 v0.30.4-0.20251216123455-0b46e74ea69b h1:0HG7ul3Q1d/E/jrZpBTpzx4xhxJwMKuq5J4nuZIogm8=
+github.com/ncruces/go-sqlite3 v0.30.4-0.20251216123455-0b46e74ea69b/go.mod h1:wz6IQnveXfqaXZozfhM8ciIJi2LRnnifBuBQarPDYo0=
 github.com/ncruces/julianday v1.0.0 h1:fH0OKwa7NWvniGQtxdJRxAgkBMolni2BjDHaWTxqt7M=
 github.com/ncruces/julianday v1.0.0/go.mod h1:Dusn2KvZrrovOMJuOt0TNXL6tB7U2E8kvza5fFc9G7g=
+github.com/ncruces/litestream v0.5.5 h1:LUoyorC+Xx0TtiuEjwd0+GIusCK5IIZwTPsO1+se55g=
+github.com/ncruces/litestream v0.5.5/go.mod h1:yLedOf7Gj4ZQQB6tCB06zm9wpNc2d8TdemfWjjc6fNk=
 github.com/ncruces/wbt v0.2.0 h1:Q9zlKOBSZc7Yy/R2cGa35g6RKUUE3BjNIW3tfGC4F04=
 github.com/ncruces/wbt v0.2.0/go.mod h1:DtF92amvMxH69EmBFUSFWRDAlo6hOEfoNQnClxj9C/c=
 github.com/pierrec/lz4/v4 v4.1.22 h1:cKFw6uJDK+/gfw5BcDL0JL5aBsAFdsIT18eRtLj7VIU=
@@ -127,8 +119,8 @@ github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c h1:+mdjkGKdHQG3305AYmd
 github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c/go.mod h1:7rwL4CYBLnjLxUqIJNnCWiEdr3bn6IUYi15bNlnbCCU=
 github.com/pkg/sftp v1.13.6 h1:JFZT4XbOU7l77xGSpOdW+pwIMqP044IyjXX6FGyEKFo=
 github.com/pkg/sftp v1.13.6/go.mod h1:tz1ryNURKu77RL+GuCzmoJYxQczL3wLNNpPWagdg4Qk=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
+github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o=
 github.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg=
 github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=
@@ -137,16 +129,16 @@ github.com/prometheus/common v0.67.4 h1:yR3NqWO1/UyO1w2PhUvXlGQs/PtFmoveVO0KZ4+L
 github.com/prometheus/common v0.67.4/go.mod h1:gP0fq6YjjNCLssJCQp0yk4M8W6ikLURwkdd/YKtTbyI=
 github.com/prometheus/procfs v0.19.2 h1:zUMhqEW66Ex7OXIiDkll3tl9a1ZdilUOd/F6ZXw4Vws=
 github.com/prometheus/procfs v0.19.2/go.mod h1:M0aotyiemPhBCM0z5w87kL22CxfcH05ZpYlu+b4J7mw=
-github.com/psanford/sqlite3vfs v0.0.0-20240315230605-24e1d98cf361 h1:vAKifIJuYY306ZJSrwDgKonWcJGELijdaenABqbV03E=
-github.com/psanford/sqlite3vfs v0.0.0-20240315230605-24e1d98cf361/go.mod h1:iW4cSew5PAb1sMZiTEkVJAIBNrepaB6jTYjeP47WtI0=
 github.com/rogpeppe/go-internal v1.12.0 h1:exVL4IDcn6na9z1rAb56Vxr+CgyK3nn3O+epU5NdKM8=
 github.com/rogpeppe/go-internal v1.12.0/go.mod h1:E+RYuTGaKKdloAfM02xzb0FW3Paa99yedzYV+kq4uf4=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-github.com/superfly/ltx v0.5.0 h1:dXNrcT3ZtMb6iKZopIV7z5UBscnapg0b0F02loQsk5o=
-github.com/superfly/ltx v0.5.0/go.mod h1:Nf50QAIXU/ET4ua3AuQ2fh31MbgNQZA7r/DYx6Os77s=
-github.com/tetratelabs/wazero v1.10.1 h1:2DugeJf6VVk58KTPszlNfeeN8AhhpwcZqkJj2wwFuH8=
-github.com/tetratelabs/wazero v1.10.1/go.mod h1:DRm5twOQ5Gr1AoEdSi0CLjDQF1J9ZAuyqFIjl1KKfQU=
+github.com/studio-b12/gowebdav v0.11.0 h1:qbQzq4USxY28ZYsGJUfO5jR+xkFtcnwWgitp4Zp1irU=
+github.com/studio-b12/gowebdav v0.11.0/go.mod h1:bHA7t77X/QFExdeAnDzK6vKM34kEZAcE1OX4MfiwjkE=
+github.com/superfly/ltx v0.5.1 h1:vGUeBhKvBKZ2s2TsTrOSahz+m0PswfqOWDAD+ICiiYY=
+github.com/superfly/ltx v0.5.1/go.mod h1:Nf50QAIXU/ET4ua3AuQ2fh31MbgNQZA7r/DYx6Os77s=
+github.com/tetratelabs/wazero v1.11.0 h1:+gKemEuKCTevU4d7ZTzlsvgd1uaToIDtlQlmNbwqYhA=
+github.com/tetratelabs/wazero v1.11.0/go.mod h1:eV28rsN8Q+xwjogd7f4/Pp4xFxO7uOGbLcD/LzB1wiU=
 go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0=
 go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo=
 go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.46.1 h1:SpGay3w+nEwMpfVnbqOLH5gY52/foP8RE8UzTZ1pdSE=
@@ -163,33 +155,34 @@ go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.yaml.in/yaml/v2 v2.4.3 h1:6gvOSjQoTB3vt1l+CU+tSyi/HOjfOjRLJ4YwYZGwRO0=
 go.yaml.in/yaml/v2 v2.4.3/go.mod h1:zSxWcmIDjOzPXpjlTTbAsKokqkDNAVtZO0WOMiT90s8=
-golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q=
-golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4=
+golang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU=
+golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0=
 golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY=
 golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU=
 golang.org/x/oauth2 v0.32.0 h1:jsCblLleRMDrxMN29H3z/k1KliIvpLgCkE6R8FXXNgY=
 golang.org/x/oauth2 v0.32.0/go.mod h1:lzm5WQJQwKZ3nwavOZ3IS5Aulzxi68dUSgRHujetwEA=
-golang.org/x/sync v0.18.0 h1:kr88TuHDroi+UVf+0hZnirlk8o8T+4MrK6mr60WkH/I=
-golang.org/x/sync v0.18.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
-golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
+golang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=
+golang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=
+golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=
+golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
 golang.org/x/time v0.5.0 h1:o7cqy6amK/52YcAKIPlM3a+Fpj35zvRj2TP+e1xFSfk=
 golang.org/x/time v0.5.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
-golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 h1:H2TDz8ibqkAF6YGhCdN3jS9O0/s90v0rJh3X/OLHEUk=
+golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2/go.mod h1:K8+ghG5WaK9qNqU5K3HdILfMLy1f3aNYFI/wnl100a8=
 google.golang.org/api v0.154.0 h1:X7QkVKZBskztmpPKWQXgjJRPA2dJYrL6r+sYPRLj050=
 google.golang.org/api v0.154.0/go.mod h1:qhSMkM85hgqiokIYsrRyKxrjfBeIhgl4Z2JmeRkYylc=
-google.golang.org/genproto v0.0.0-20231212172506-995d672761c0 h1:YJ5pD9rF8o9Qtta0Cmy9rdBwkSjrTCT6XTiUQVOtIos=
-google.golang.org/genproto v0.0.0-20231212172506-995d672761c0/go.mod h1:l/k7rMz0vFTBPy+tFSGvXEd3z+BcoG1k7EHbqm+YBsY=
-google.golang.org/genproto/googleapis/api v0.0.0-20231212172506-995d672761c0 h1:s1w3X6gQxwrLEpxnLd/qXTVLgQE2yXwaOaoa6IlY/+o=
-google.golang.org/genproto/googleapis/api v0.0.0-20231212172506-995d672761c0/go.mod h1:CAny0tYF+0/9rmDB9fahA9YLzX3+AEVl1qXbv5hhj6c=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20231212172506-995d672761c0 h1:/jFB8jK5R3Sq3i/lmeZO0cATSzFfZaJq1J2Euan3XKU=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20231212172506-995d672761c0/go.mod h1:FUoWkonphQm3RhTS+kOEhF8h0iDpm4tdXolVCeZ9KKA=
-google.golang.org/grpc v1.60.1 h1:26+wFr+cNqSGFcOXcabYC0lUVJVRa2Sb2ortSK7VrEU=
-google.golang.org/grpc v1.60.1/go.mod h1:OlCHIeLYqSSsLi6i49B5QGdzaMZK9+M7LXN2FKz4eGM=
-google.golang.org/protobuf v1.36.10 h1:AYd7cD/uASjIL6Q9LiTjz8JLcrh/88q5UObnmY3aOOE=
-google.golang.org/protobuf v1.36.10/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
+google.golang.org/genproto v0.0.0-20231120223509-83a465c0220f h1:Vn+VyHU5guc9KjB5KrjI2q0wCOWEOIh0OEsleqakHJg=
+google.golang.org/genproto v0.0.0-20231120223509-83a465c0220f/go.mod h1:nWSwAFPb+qfNJXsoeO3Io7zf4tMSfN8EA8RlDA04GhY=
+google.golang.org/genproto/googleapis/api v0.0.0-20231120223509-83a465c0220f h1:2yNACc1O40tTnrsbk9Cv6oxiW8pxI/pXj0wRtdlYmgY=
+google.golang.org/genproto/googleapis/api v0.0.0-20231120223509-83a465c0220f/go.mod h1:Uy9bTZJqmfrw2rIBxgGLnamc78euZULUBrLZ9XTITKI=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20231127180814-3a041ad873d4 h1:DC7wcm+i+P1rN3Ff07vL+OndGg5OhNddHyTA+ocPqYE=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20231127180814-3a041ad873d4/go.mod h1:eJVxU6o+4G1PSczBr85xmyvSNYAKvAYgkub40YGomFM=
+google.golang.org/grpc v1.59.0 h1:Z5Iec2pjwb+LEOqzpB2MR12/eKFhDPhuqW91O+4bwUk=
+google.golang.org/grpc v1.59.0/go.mod h1:aUPDwccQo6OTjy7Hct4AfBPD1GptF4fyUjIkQ9YtF98=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
--- a/litestream/modernc/go.mod
+++ b/litestream/modernc/go.mod
@@ -1,11 +0,0 @@
-module modernc.org/sqlite
-
-go 1.24.0
-
-require github.com/ncruces/go-sqlite3 v0.30.1
-
-require (
-	github.com/ncruces/julianday v1.0.0 // indirect
-	github.com/tetratelabs/wazero v1.10.1 // indirect
-	golang.org/x/sys v0.38.0 // indirect
-)
--- a/litestream/modernc/go.sum
+++ b/litestream/modernc/go.sum
@@ -1,10 +0,0 @@
-github.com/ncruces/go-sqlite3 v0.30.1 h1:pHC3YsyRdJv4pCMB4MO1Q2BXw/CAa+Hoj7GSaKtVk+g=
-github.com/ncruces/go-sqlite3 v0.30.1/go.mod h1:UVsWrQaq1qkcal5/vT5lOJnZCVlR5rsThKdwidjFsKc=
-github.com/ncruces/julianday v1.0.0 h1:fH0OKwa7NWvniGQtxdJRxAgkBMolni2BjDHaWTxqt7M=
-github.com/ncruces/julianday v1.0.0/go.mod h1:Dusn2KvZrrovOMJuOt0TNXL6tB7U2E8kvza5fFc9G7g=
-github.com/tetratelabs/wazero v1.10.1 h1:2DugeJf6VVk58KTPszlNfeeN8AhhpwcZqkJj2wwFuH8=
-github.com/tetratelabs/wazero v1.10.1/go.mod h1:DRm5twOQ5Gr1AoEdSi0CLjDQF1J9ZAuyqFIjl1KKfQU=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
-golang.org/x/text v0.30.0 h1:yznKA/E9zq54KzlzBEAWn1NXSQ8DIp/NYMy88xJjl4k=
-golang.org/x/text v0.30.0/go.mod h1:yDdHFIX9t+tORqspjENWgzaCVXgk0yYnYuSZ8UzzBVM=
--- a/litestream/modernc/sqlite.go
+++ b/litestream/modernc/sqlite.go
@@ -1,20 +0,0 @@
-// Package sqlite provides a shim that allows Litestream to work with the ncruces SQLite driver.
-package sqlite
-
-import (
-	"database/sql"
-	"slices"
-
-	"github.com/ncruces/go-sqlite3/driver"
-	_ "github.com/ncruces/go-sqlite3/embed"
-)
-
-func init() {
-	if !slices.Contains(sql.Drivers(), "sqlite") {
-		sql.Register("sqlite", &driver.SQLite{})
-	}
-}
-
-type FileControl interface {
-	FileControlPersistWAL(string, int) (int, error)
-}
--- a/litestream/time.go
+++ b/litestream/time.go
@@ -0,0 +1,63 @@
+package litestream
+
+import (
+	"math"
+	"strings"
+	"time"
+
+	"github.com/ncruces/go-sqlite3/util/sql3util"
+)
+
+func parseTimeDelta(s string) (years, months, days int, duration time.Duration, ok bool) {
+	duration, err := time.ParseDuration(s)
+	if err == nil {
+		return 0, 0, 0, duration, true
+	}
+
+	if strings.EqualFold(s, "now") {
+		return 0, 0, 0, 0, true
+	}
+
+	ss := strings.TrimSuffix(strings.ToLower(s), "s")
+	switch {
+	case strings.HasSuffix(ss, " year"):
+		years, duration, ok = parseDateUnit(ss, " year", 365*86400)
+
+	case strings.HasSuffix(ss, " month"):
+		months, duration, ok = parseDateUnit(ss, " month", 30*86400)
+
+	case strings.HasSuffix(ss, " day"):
+		months, duration, ok = parseDateUnit(ss, " day", 86400)
+
+	case strings.HasSuffix(ss, " hour"):
+		duration, ok = parseTimeUnit(ss, " hour", time.Hour)
+
+	case strings.HasSuffix(ss, " minute"):
+		duration, ok = parseTimeUnit(ss, " minute", time.Minute)
+
+	case strings.HasSuffix(ss, " second"):
+		duration, ok = parseTimeUnit(ss, " second", time.Second)
+
+	default:
+		return sql3util.ParseTimeShift(s)
+	}
+	return
+}
+
+func parseDateUnit(s, unit string, seconds float64) (int, time.Duration, bool) {
+	f, ok := sql3util.ParseFloat(s[:len(s)-len(unit)])
+	if !ok {
+		return 0, 0, false
+	}
+
+	i, f := math.Modf(f)
+	if math.MinInt <= i && i <= math.MaxInt {
+		return int(i), time.Duration(f * seconds * float64(time.Second)), true
+	}
+	return 0, 0, false
+}
+
+func parseTimeUnit(s, unit string, scale time.Duration) (time.Duration, bool) {
+	f, ok := sql3util.ParseFloat(s[:len(s)-len(unit)])
+	return time.Duration(f * float64(scale)), ok
+}
--- a/litestream/vfs.go
+++ b/litestream/vfs.go
@@ -6,6 +6,8 @@ import (
 	"errors"
 	"fmt"
 	"io"
+	"strconv"
+	"strings"
 	"sync"
 	"time"

@@ -61,8 +63,10 @@ type liteFile struct {
 	db       *liteDB
 	conn     *sqlite3.Conn
 	pages    *pageIndex
+	syncTime time.Time
 	txid     ltx.TXID
 	pageSize uint32
+	locked   bool
 }

 func (f *liteFile) Close() error { return nil }
@@ -70,10 +74,11 @@ func (f *liteFile) Close() error { return nil }
 func (f *liteFile) ReadAt(p []byte, off int64) (n int, err error) {
 	ctx := f.context()
 	pages, txid := f.pages, f.txid
-	if pages == nil {
+	if pages == nil && f.syncTime.IsZero() {
 		pages, txid, err = f.db.pollReplica(ctx)
 	}
 	if err != nil {
+		f.db.opts.Logger.Error("poll replica", "error", err)
 		return 0, err
 	}

@@ -87,10 +92,7 @@ func (f *liteFile) ReadAt(p []byte, off int64) (n int, err error) {
 		return 0, io.EOF
 	}

-	data, err := f.db.cache.getOrFetch(pgno, elem.MaxTXID, func() (any, error) {
-		_, data, err := litestream.FetchPage(ctx, f.db.client, elem.Level, elem.MinTXID, elem.MaxTXID, elem.Offset, elem.Size)
-		return data, err
-	})
+	data, err := f.db.cache.getOrFetch(ctx, f.db.client, pgno, elem)
 	if err != nil {
 		f.db.opts.Logger.Error("fetch page", "error", err)
 		return 0, err
@@ -134,14 +136,25 @@ func (f *liteFile) Size() (size int64, err error) {

 func (f *liteFile) Lock(lock vfs.LockLevel) (err error) {
 	if lock >= vfs.LOCK_RESERVED {
+		// notest // OPEN_READONLY
 		return sqlite3.IOERR_LOCK
 	}
-	f.pages, f.txid, err = f.db.pollReplica(f.context())
+	if f.syncTime.IsZero() {
+		f.pages, f.txid, err = f.db.pollReplica(f.context())
+	}
+	if err != nil {
+		f.db.opts.Logger.Error("poll replica", "error", err)
+	} else {
+		f.locked = true
+	}
 	return err
 }

 func (f *liteFile) Unlock(lock vfs.LockLevel) error {
-	f.pages, f.txid = nil, 0
+	if f.syncTime.IsZero() {
+		f.pages, f.txid = nil, 0
+	}
+	f.locked = false
 	return nil
 }

@@ -160,6 +173,72 @@ func (f *liteFile) DeviceCharacteristics() vfs.DeviceCharacteristic {
 	return 0
 }

+func (f *liteFile) Pragma(name, value string) (string, error) {
+	switch name {
+	case "litestream_txid":
+		txid := f.txid
+		if txid == 0 {
+			f.db.mtx.Lock()
+			txid = f.db.txids[0]
+			f.db.mtx.Unlock()
+		}
+		return txid.String(), nil
+
+	case "litestream_lag":
+		f.db.mtx.Lock()
+		lastPoll := f.db.lastPoll
+		f.db.mtx.Unlock()
+
+		if lastPoll.IsZero() {
+			return "-1", nil
+		}
+		lag := time.Since(lastPoll) / time.Second
+		return strconv.FormatInt(int64(lag), 10), nil
+
+	case "litestream_time":
+		if value == "" {
+			syncTime := f.syncTime
+			if syncTime.IsZero() {
+				f.db.mtx.Lock()
+				syncTime = f.db.lastInfo
+				f.db.mtx.Unlock()
+			}
+			if syncTime.IsZero() {
+				return "latest", nil
+			}
+			return syncTime.Format(time.RFC3339Nano), nil
+		}
+
+		if f.locked {
+			return "", sqlite3.MISUSE
+		}
+
+		if strings.EqualFold(value, "latest") {
+			f.syncTime = time.Time{}
+			f.pages, f.txid = nil, 0
+			return "", nil
+		}
+
+		var syncTime time.Time
+		if years, months, days, duration, ok := parseTimeDelta(value); ok {
+			syncTime = time.Now().AddDate(years, months, days).Add(duration)
+		} else {
+			syncTime, _ = sqlite3.TimeFormatAuto.Decode(value)
+		}
+		if syncTime.IsZero() {
+			return "", sqlite3.MISUSE
+		}
+
+		err := f.buildIndex(f.context(), syncTime)
+		if err != nil {
+			f.db.opts.Logger.Error("build index", "error", err)
+		}
+		return "", err
+	}
+
+	return "", sqlite3.NOTFOUND
+}
+
 func (f *liteFile) SetDB(conn any) {
 	f.conn = conn.(*sqlite3.Conn)
 }
@@ -171,76 +250,95 @@ func (f *liteFile) context() context.Context {
 	return context.Background()
 }

+func (f *liteFile) buildIndex(ctx context.Context, syncTime time.Time) error {
+	// Build the index from scratch from a Litestream restore plan.
+	infos, err := litestream.CalcRestorePlan(ctx, f.db.client, 0, syncTime, f.db.opts.Logger)
+	if err != nil && !errors.Is(err, litestream.ErrTxNotAvailable) {
+		return fmt.Errorf("calc restore plan: %w", err)
+	}
+
+	var txid ltx.TXID
+	var pages *pageIndex
+	for _, info := range infos {
+		pages, err = fetchPageIndex(ctx, pages, f.db.client, info)
+		if err != nil {
+			return err
+		}
+		txid = max(txid, info.MaxTXID)
+	}
+	f.syncTime = syncTime
+	f.pages = pages
+	f.txid = txid
+	return nil
+}
+
 type liteDB struct {
 	client   litestream.ReplicaClient
 	opts     ReplicaOptions
 	cache    pageCache
 	pages    *pageIndex // +checklocks:mtx
 	lastPoll time.Time  // +checklocks:mtx
+	lastInfo time.Time  // +checklocks:mtx
 	txids    levelTXIDs // +checklocks:mtx
 	mtx      sync.Mutex
 }

-func (f *liteDB) buildIndex(ctx context.Context) error {
-	f.mtx.Lock()
-	defer f.mtx.Unlock()
+func (d *liteDB) buildIndex(ctx context.Context) error {
+	d.mtx.Lock()
+	defer d.mtx.Unlock()

 	// Skip if we already have an index.
-	if f.pages != nil {
+	if !d.lastPoll.IsZero() {
 		return nil
 	}

 	// Build the index from scratch from a Litestream restore plan.
-	infos, err := litestream.CalcRestorePlan(ctx, f.client, 0, time.Time{}, f.opts.Logger)
-	if err != nil {
-		if !errors.Is(err, litestream.ErrTxNotAvailable) {
-			return fmt.Errorf("calc restore plan: %w", err)
-		}
-		return nil
+	infos, err := litestream.CalcRestorePlan(ctx, d.client, 0, time.Time{}, d.opts.Logger)
+	if err != nil && !errors.Is(err, litestream.ErrTxNotAvailable) {
+		return fmt.Errorf("calc restore plan: %w", err)
 	}

 	for _, info := range infos {
-		err := f.updateInfo(ctx, info)
+		err := d.updateInfo(ctx, info)
 		if err != nil {
 			return err
 		}
 	}

-	f.lastPoll = time.Now()
+	d.lastPoll = time.Now()
 	return nil
 }

-func (f *liteDB) pollReplica(ctx context.Context) (*pageIndex, ltx.TXID, error) {
-	f.mtx.Lock()
-	defer f.mtx.Unlock()
+func (d *liteDB) pollReplica(ctx context.Context) (*pageIndex, ltx.TXID, error) {
+	d.mtx.Lock()
+	defer d.mtx.Unlock()

 	// Limit polling interval.
-	if time.Since(f.lastPoll) < f.opts.PollInterval {
-		return f.pages, f.txids[0], nil
+	if time.Since(d.lastPoll) < d.opts.PollInterval {
+		return d.pages, d.txids[0], nil
 	}

-	for level := range pollLevels(f.opts.MinLevel) {
-		if err := f.updateLevel(ctx, level); err != nil {
-			f.opts.Logger.Error("cannot poll replica", "error", err)
+	for level := range []int{0, 1, litestream.SnapshotLevel} {
+		if err := d.updateLevel(ctx, level); err != nil {
 			return nil, 0, err
 		}
 	}

-	f.lastPoll = time.Now()
-	return f.pages, f.txids[0], nil
+	d.lastPoll = time.Now()
+	return d.pages, d.txids[0], nil
 }

-// +checklocks:f.mtx
-func (f *liteDB) updateLevel(ctx context.Context, level int) error {
+// +checklocks:d.mtx
+func (d *liteDB) updateLevel(ctx context.Context, level int) error {
 	var nextTXID ltx.TXID
 	// Snapshots must start from scratch,
 	// other levels can start from where they were left.
 	if level != litestream.SnapshotLevel {
-		nextTXID = f.txids[level] + 1
+		nextTXID = d.txids[level] + 1
 	}

 	// Start reading from the next LTX file after the current position.
-	itr, err := f.client.LTXFiles(ctx, level, nextTXID, false)
+	itr, err := d.client.LTXFiles(ctx, level, nextTXID, false)
 	if err != nil {
 		return fmt.Errorf("ltx files: %w", err)
 	}
@@ -251,11 +349,11 @@ func (f *liteDB) updateLevel(ctx context.Context, level int) error {
 		info := itr.Item()

 		// Skip LTX files already fully loaded into the index.
-		if info.MaxTXID <= f.txids[level] {
+		if info.MaxTXID <= d.txids[level] {
 			continue
 		}

-		err := f.updateInfo(ctx, info)
+		err := d.updateInfo(ctx, info)
 		if err != nil {
 			return err
 		}
@@ -266,42 +364,41 @@ func (f *liteDB) updateLevel(ctx context.Context, level int) error {
 	return itr.Close()
 }

-// +checklocks:f.mtx
-func (f *liteDB) updateInfo(ctx context.Context, info *ltx.FileInfo) error {
-	idx, err := litestream.FetchPageIndex(ctx, f.client, info)
+// +checklocks:d.mtx
+func (d *liteDB) updateInfo(ctx context.Context, info *ltx.FileInfo) error {
+	pages, err := fetchPageIndex(ctx, d.pages, d.client, info)
 	if err != nil {
-		return fmt.Errorf("fetch page index: %w", err)
+		return err
+	}
+
+	// Track the MaxTXID for each level.
+	maxTXID := &d.txids[info.Level]
+	*maxTXID = max(*maxTXID, info.MaxTXID)
+	d.txids[0] = max(d.txids[0], *maxTXID)
+	if d.lastInfo.Before(info.CreatedAt) {
+		d.lastInfo = info.CreatedAt
+	}
+	d.pages = pages
+	return nil
+}
+
+func fetchPageIndex(
+	ctx context.Context, pages *pageIndex,
+	client litestream.ReplicaClient, info *ltx.FileInfo) (*pageIndex, error) {
+
+	idx, err := litestream.FetchPageIndex(ctx, client, info)
+	if err != nil {
+		return nil, fmt.Errorf("fetch page index: %w", err)
 	}

 	// Replace pages in the index with new pages.
 	for k, v := range idx {
 		// Patch avoids mutating the index for an unmodified page.
-		f.pages = f.pages.Patch(k, func(node *pageIndex) (ltx.PageIndexElem, bool) {
+		pages = pages.Patch(k, func(node *pageIndex) (ltx.PageIndexElem, bool) {
 			return v, node == nil || v != node.Value()
 		})
 	}
-
-	// Track the MaxTXID for each level.
-	maxTXID := &f.txids[info.Level]
-	*maxTXID = max(*maxTXID, info.MaxTXID)
-	return nil
-}
-
-func pollLevels(minLevel int) (r []int) {
-	// Updating from lower to upper levels is non-racy,
-	// since LTX files are compacted into higher levels
-	// before the lower level LTX files are deleted.
-
-	// Also, only level 0 compactions and snapshots delete files,
-	// so the intermediate levels never need to be updated.
-
-	if minLevel <= 0 {
-		return append(r, 0, 1, litestream.SnapshotLevel)
-	}
-	if minLevel >= litestream.SnapshotLevel {
-		return append(r, litestream.SnapshotLevel)
-	}
-	return append(r, minLevel, litestream.SnapshotLevel)
+	return pages, nil
 }

 // Type aliases; these are a mouthful.
--- a/litestream/vfs_test.go
+++ b/litestream/vfs_test.go
@@ -1,34 +1,133 @@
 package litestream

 import (
-	"slices"
-	"strconv"
+	"path/filepath"
 	"testing"
+	"time"

 	"github.com/benbjohnson/litestream"
-
+	"github.com/benbjohnson/litestream/file"
+	"github.com/ncruces/go-sqlite3/driver"
 	_ "github.com/ncruces/go-sqlite3/embed"
 )

-func Test_pollLevels(t *testing.T) {
-	tests := []struct {
-		minLevel int
-		want     []int
-	}{
-		{minLevel: -1, want: []int{0, 1, litestream.SnapshotLevel}},
-		{minLevel: 0, want: []int{0, 1, litestream.SnapshotLevel}},
-		{minLevel: 1, want: []int{1, litestream.SnapshotLevel}},
-		{minLevel: 2, want: []int{2, litestream.SnapshotLevel}},
-		{minLevel: 3, want: []int{3, litestream.SnapshotLevel}},
-		{minLevel: litestream.SnapshotLevel, want: []int{litestream.SnapshotLevel}},
-		{minLevel: litestream.SnapshotLevel + 1, want: []int{litestream.SnapshotLevel}},
+func Test_integration(t *testing.T) {
+	dir := t.TempDir()
+	dbpath := filepath.Join(dir, "test.db")
+	backup := filepath.Join(dir, "backup", "test.db")
+
+	db, err := driver.Open(dbpath)
+	if err != nil {
+		t.Fatal(err)
 	}
-	for _, tt := range tests {
-		t.Run(strconv.Itoa(tt.minLevel), func(t *testing.T) {
-			got := pollLevels(tt.minLevel)
-			if !slices.Equal(got, tt.want) {
-				t.Errorf("pollLevels() = %v, want %v", got, tt.want)
-			}
-		})
+	defer db.Close()
+
+	client := file.NewReplicaClient(backup)
+	setupReplication(t, dbpath, client)
+
+	NewReplica("test.db", client, ReplicaOptions{})
+	replica, err := driver.Open("file:test.db?vfs=litestream")
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer replica.Close()
+
+	_, err = db.ExecContext(t.Context(), `CREATE TABLE users (id INT, name VARCHAR(10))`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	_, err = db.ExecContext(t.Context(),
+		`INSERT INTO users (id, name) VALUES (0, 'go'), (1, 'zig'), (2, 'whatever')`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	time.Sleep(DefaultPollInterval + litestream.DefaultMonitorInterval)
+
+	rows, err := replica.QueryContext(t.Context(), `SELECT id, name FROM users`)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer rows.Close()
+
+	row := 0
+	ids := []int{0, 1, 2}
+	names := []string{"go", "zig", "whatever"}
+	for ; rows.Next(); row++ {
+		var id int
+		var name string
+		err := rows.Scan(&id, &name)
+		if err != nil {
+			t.Fatal(err)
+		}
+
+		if id != ids[row] {
+			t.Errorf("got %d, want %d", id, ids[row])
+		}
+		if name != names[row] {
+			t.Errorf("got %q, want %q", name, names[row])
+		}
+	}
+	if row != 3 {
+		t.Errorf("got %d, want %d", row, len(ids))
+	}
+
+	var lag int
+	err = replica.QueryRowContext(t.Context(), `PRAGMA litestream_lag`).Scan(&lag)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if lag < 0 || lag > 2 {
+		t.Errorf("got %d", lag)
+	}
+
+	var txid string
+	err = replica.QueryRowContext(t.Context(), `PRAGMA litestream_txid`).Scan(&txid)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if txid != "0000000000000001" {
+		t.Errorf("got %q", txid)
+	}
+
+	_, err = replica.ExecContext(t.Context(), `PRAGMA litestream_time='-1.5h'`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	_, err = replica.ExecContext(t.Context(), `PRAGMA litestream_time='-00:01'`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	_, err = replica.ExecContext(t.Context(), `PRAGMA litestream_time='-2.5 years'`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	_, err = replica.ExecContext(t.Context(), `PRAGMA litestream_time='1970-01-01'`)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	var sync time.Time
+	err = replica.QueryRowContext(t.Context(), `PRAGMA litestream_time`).Scan(&sync)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !sync.Equal(time.Unix(0, 0)) {
+		t.Errorf("got %v", sync)
 	}
 }
+
+func setupReplication(tb testing.TB, path string, client ReplicaClient) {
+	lsdb := litestream.NewDB(path)
+	lsdb.Replica = litestream.NewReplicaWithClient(lsdb, client)
+
+	err := lsdb.Open()
+	if err != nil {
+		tb.Fatal(err)
+	}
+	tb.Cleanup(func() { lsdb.Close(tb.Context()) })
+}
--- a/sqlite3/download.sh
+++ b/sqlite3/download.sh
@@ -3,11 +3,11 @@ set -euo pipefail

 cd -P -- "$(dirname -- "$0")"

-curl -#OL "https://sqlite.org/2025/sqlite-autoconf-3510000.tar.gz"
+curl -#OL "https://sqlite.org/2025/sqlite-autoconf-3510100.tar.gz"

 # Verify download.
 if hash=$(openssl dgst -sha3-256 sqlite-autoconf-*.tar.gz); then
-  if ! [[ $hash =~ fa52f9cc74dbca004aa650ae698036a3350611f672649e165078f4eae21d6a2e ]]; then
+  if ! [[ $hash =~ 9b2b1e73f577def1d5b75c5541555a7f42e6e073ad19f7a9118478389c9bbd9b ]]; then
    echo $hash
    exit 1
  fi
@@ -23,7 +23,7 @@ mv sqlite-*/sqlite3.h .
 mv sqlite-*/sqlite3ext.h .
 rm -r sqlite-*

-GITHUB_TAG="https://github.com/sqlite/sqlite/raw/version-3.51.0"
+GITHUB_TAG="https://github.com/sqlite/sqlite/raw/version-3.51.1"

 mkdir -p ext/
 cd ext/
--- a/sqlite3/libc/libc.wasm
+++ b/sqlite3/libc/libc.wasm
--- a/sqlite3/libc/libc.wat
+++ b/sqlite3/libc/libc.wat
@@ -4,7 +4,8 @@
 (type $2 (func (param i32 i32 i32 i32)))
 (type $3 (func (param i32) (result i32)))
 (memory $0 256)
- (data $0 (i32.const 4096) "\01")
+ (data $.data (i32.const 4097) "\10\00\00\01\00\00\00\00\00\00\00\0c\10\00\00\0c\10\00\00\0c\10")
+ (data $.data.1 (i32.const 4157) "\10\00\00\00\10")
 (table $0 1 1 funcref)
 (export "memory" (memory $0))
 (export "qsort" (func $qsort))
@@ -1493,33 +1494,243 @@
  (local $2 i32)
  (local $3 i32)
  (local $4 i32)
-  (local $5 i32)
+  (local $5 v128)
  (local $6 v128)
  (local $7 v128)
  (local $8 v128)
-  (local $9 v128)
-  (block $block
-   (if
-    (local.tee $3
-     (i32.load8_u
-      (local.get $1)
+  (block $block2
+   (block $block
+    (br_if $block
+     (i32.eqz
+      (local.tee $3
+       (i32.load8_u
+        (local.get $1)
+       )
+      )
     )
    )
-    (then
-     (br_if $block
+    (br_if $block
+     (i32.eqz
      (i32.load8_u offset=1
       (local.get $1)
      )
     )
    )
+    (loop $label
+     (v128.store
+      (i32.const 4080)
+      (local.get $6)
+     )
+     (i32.store8
+      (i32.or
+       (local.tee $3
+        (i32.and
+         (local.tee $2
+          (i32.load8_u
+           (local.get $1)
+          )
+         )
+         (i32.const 15)
+        )
+       )
+       (i32.const 4080)
+      )
+      (i32.or
+       (i32.load8_u
+        (i32.or
+         (local.get $3)
+         (i32.const 4080)
+        )
+       )
+       (i32.shl
+        (i32.const 1)
+        (i32.sub
+         (local.tee $4
+          (i32.shr_u
+           (local.get $2)
+           (i32.const 4)
+          )
+         )
+         (i32.const 8)
+        )
+       )
+      )
+     )
+     (v128.store
+      (i32.const 4064)
+      (local.get $5)
+     )
+     (i32.store8
+      (local.tee $3
+       (i32.or
+        (local.get $3)
+        (i32.const 4064)
+       )
+      )
+      (i32.or
+       (i32.load8_u
+        (local.get $3)
+       )
+       (i32.shl
+        (i32.const 1)
+        (local.get $4)
+       )
+      )
+     )
+     (local.set $1
+      (i32.add
+       (local.get $1)
+       (i32.const 1)
+      )
+     )
+     (local.set $6
+      (v128.load
+       (i32.const 4080)
+      )
+     )
+     (local.set $5
+      (v128.load
+       (i32.const 4064)
+      )
+     )
+     (br_if $label
+      (local.get $2)
+     )
+    )
+    (block $block1
+     (if
+      (v128.any_true
+       (local.tee $7
+        (v128.and
+         (v128.or
+          (i8x16.swizzle
+           (local.get $6)
+           (v128.xor
+            (local.tee $8
+             (v128.and
+              (local.tee $7
+               (v128.load
+                (local.tee $2
+                 (i32.and
+                  (local.get $0)
+                  (i32.const -16)
+                 )
+                )
+               )
+              )
+              (v128.const i32x4 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f)
+             )
+            )
+            (v128.const i32x4 0x80808080 0x80808080 0x80808080 0x80808080)
+           )
+          )
+          (i8x16.swizzle
+           (local.get $5)
+           (local.get $8)
+          )
+         )
+         (i8x16.swizzle
+          (v128.const i32x4 0x08040201 0x80402010 0x08040201 0x80402010)
+          (i8x16.shr_u
+           (local.get $7)
+           (i32.const 4)
+          )
+         )
+        )
+       )
+      )
+      (then
+       (br_if $block1
+        (local.tee $1
+         (i32.and
+          (i32.xor
+           (i8x16.bitmask
+            (i8x16.eq
+             (local.get $7)
+             (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
+            )
+           )
+           (i32.const 65535)
+          )
+          (i32.shl
+           (i32.const -1)
+           (i32.and
+            (local.get $0)
+            (i32.const 15)
+           )
+          )
+         )
+        )
+       )
+      )
+     )
+     (loop $label1
+      (br_if $label1
+       (i32.eqz
+        (v128.any_true
+         (local.tee $7
+          (v128.and
+           (v128.or
+            (i8x16.swizzle
+             (local.get $6)
+             (v128.xor
+              (local.tee $8
+               (v128.and
+                (local.tee $7
+                 (v128.load
+                  (local.tee $2
+                   (i32.add
+                    (local.get $2)
+                    (i32.const 16)
+                   )
+                  )
+                 )
+                )
+                (v128.const i32x4 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f)
+               )
+              )
+              (v128.const i32x4 0x80808080 0x80808080 0x80808080 0x80808080)
+             )
+            )
+            (i8x16.swizzle
+             (local.get $5)
+             (local.get $8)
+            )
+           )
+           (i8x16.swizzle
+            (v128.const i32x4 0x08040201 0x80402010 0x08040201 0x80402010)
+            (i8x16.shr_u
+             (local.get $7)
+             (i32.const 4)
+            )
+           )
+          )
+         )
+        )
+       )
+      )
+     )
+     (local.set $1
+      (i32.xor
+       (i8x16.bitmask
+        (i8x16.eq
+         (local.get $7)
+         (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
+        )
+       )
+       (i32.const 65535)
+      )
+     )
+    )
+    (br $block2)
   )
-   (block $block1
+   (block $block3
    (if
     (v128.any_true
-      (local.tee $6
+      (local.tee $5
       (v128.or
        (i8x16.eq
-         (local.tee $7
+         (local.tee $6
          (v128.load
           (local.tee $2
            (i32.and
@@ -1532,8 +1743,8 @@
         (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
        )
        (i8x16.eq
-         (local.get $7)
-         (local.tee $7
+         (local.get $6)
+         (local.tee $6
          (i8x16.splat
           (local.get $3)
          )
@@ -1543,11 +1754,11 @@
      )
     )
     (then
-      (br_if $block1
+      (br_if $block3
       (local.tee $1
        (i32.and
         (i8x16.bitmask
-          (local.get $6)
+          (local.get $5)
         )
         (i32.shl
          (i32.const -1)
@@ -1561,14 +1772,14 @@
      )
     )
    )
-    (loop $label
-     (br_if $label
+    (loop $label2
+     (br_if $label2
      (i32.eqz
       (v128.any_true
-        (local.tee $6
+        (local.tee $5
         (v128.or
          (i8x16.eq
-           (local.tee $6
+           (local.tee $5
            (v128.load
             (local.tee $2
              (i32.add
@@ -1581,8 +1792,8 @@
           (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
          )
          (i8x16.eq
+           (local.get $5)
           (local.get $6)
-           (local.get $7)
          )
         )
        )
@@ -1592,230 +1803,10 @@
    )
    (local.set $1
     (i8x16.bitmask
-      (local.get $6)
-     )
-    )
-   )
-   (return
-    (i32.add
-     (i32.ctz
-      (local.get $1)
-     )
-     (i32.sub
-      (local.get $2)
-      (local.get $0)
-     )
-    )
-   )
-  )
-  (local.set $4
-   (i32.and
-    (local.get $0)
-    (i32.const 15)
-   )
-  )
-  (loop $label1
-   (v128.store
-    (i32.const 4080)
-    (local.get $7)
-   )
-   (i32.store8
-    (i32.or
-     (local.tee $3
-      (i32.and
-       (local.tee $2
-        (i32.load8_u
-         (local.get $1)
-        )
-       )
-       (i32.const 15)
-      )
-     )
-     (i32.const 4080)
-    )
-    (i32.or
-     (i32.load8_u
-      (i32.or
-       (local.get $3)
-       (i32.const 4080)
-      )
-     )
-     (i32.shl
-      (i32.const 1)
-      (i32.sub
-       (local.tee $5
-        (i32.shr_u
-         (local.get $2)
-         (i32.const 4)
-        )
-       )
-       (i32.const 8)
-      )
-     )
-    )
-   )
-   (v128.store
-    (i32.const 4064)
-    (local.get $6)
-   )
-   (i32.store8
-    (local.tee $3
-     (i32.or
-      (local.get $3)
-      (i32.const 4064)
-     )
-    )
-    (i32.or
-     (i32.load8_u
-      (local.get $3)
-     )
-     (i32.shl
-      (i32.const 1)
      (local.get $5)
     )
    )
   )
-   (local.set $1
-    (i32.add
-     (local.get $1)
-     (i32.const 1)
-    )
-   )
-   (local.set $7
-    (v128.load
-     (i32.const 4080)
-    )
-   )
-   (local.set $6
-    (v128.load
-     (i32.const 4064)
-    )
-   )
-   (br_if $label1
-    (local.get $2)
-   )
-  )
-  (block $block2
-   (if
-    (v128.any_true
-     (local.tee $8
-      (v128.and
-       (v128.or
-        (i8x16.swizzle
-         (local.get $7)
-         (v128.xor
-          (local.tee $9
-           (v128.and
-            (local.tee $8
-             (v128.load
-              (local.tee $2
-               (i32.and
-                (local.get $0)
-                (i32.const -16)
-               )
-              )
-             )
-            )
-            (v128.const i32x4 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f)
-           )
-          )
-          (v128.const i32x4 0x80808080 0x80808080 0x80808080 0x80808080)
-         )
-        )
-        (i8x16.swizzle
-         (local.get $6)
-         (local.get $9)
-        )
-       )
-       (i8x16.swizzle
-        (v128.const i32x4 0x08040201 0x80402010 0x08040201 0x80402010)
-        (i8x16.shr_u
-         (local.get $8)
-         (i32.const 4)
-        )
-       )
-      )
-     )
-    )
-    (then
-     (br_if $block2
-      (local.tee $1
-       (i32.and
-        (i32.xor
-         (i8x16.bitmask
-          (i8x16.eq
-           (local.get $8)
-           (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
-          )
-         )
-         (i32.const 65535)
-        )
-        (i32.shl
-         (i32.const -1)
-         (local.get $4)
-        )
-       )
-      )
-     )
-    )
-   )
-   (loop $label2
-    (br_if $label2
-     (i32.eqz
-      (v128.any_true
-       (local.tee $8
-        (v128.and
-         (v128.or
-          (i8x16.swizzle
-           (local.get $7)
-           (v128.xor
-            (local.tee $9
-             (v128.and
-              (local.tee $8
-               (v128.load
-                (local.tee $2
-                 (i32.add
-                  (local.get $2)
-                  (i32.const 16)
-                 )
-                )
-               )
-              )
-              (v128.const i32x4 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f 0x8f8f8f8f)
-             )
-            )
-            (v128.const i32x4 0x80808080 0x80808080 0x80808080 0x80808080)
-           )
-          )
-          (i8x16.swizzle
-           (local.get $6)
-           (local.get $9)
-          )
-         )
-         (i8x16.swizzle
-          (v128.const i32x4 0x08040201 0x80402010 0x08040201 0x80402010)
-          (i8x16.shr_u
-           (local.get $8)
-           (i32.const 4)
-          )
-         )
-        )
-       )
-      )
-     )
-    )
-   )
-   (local.set $1
-    (i32.xor
-     (i8x16.bitmask
-      (i8x16.eq
-       (local.get $8)
-       (v128.const i32x4 0x00000000 0x00000000 0x00000000 0x00000000)
-      )
-     )
-     (i32.const 65535)
-    )
-   )
  )
  (i32.add
   (i32.ctz
--- a/time.go
+++ b/time.go
@@ -7,6 +7,7 @@ import (
 	"time"

 	"github.com/ncruces/go-sqlite3/internal/util"
+	"github.com/ncruces/go-sqlite3/util/sql3util"
 	"github.com/ncruces/julianday"
 )

@@ -157,11 +158,13 @@ func (f TimeFormat) Decode(v any) (time.Time, error) {

 	case TimeFormatUnix, TimeFormatUnixFrac:
 		if s, ok := v.(string); ok {
-			f, err := strconv.ParseFloat(s, 64)
-			if err != nil {
-				return time.Time{}, err
+			if i, err := strconv.ParseInt(s, 10, 64); err == nil {
+				v = i
+			} else if f, ok := sql3util.ParseFloat(s); ok {
+				v = f
+			} else {
+				return time.Time{}, util.TimeErr
 			}
-			v = f
 		}
 		switch v := v.(type) {
 		case float64:
@@ -234,8 +237,8 @@ func (f TimeFormat) Decode(v any) (time.Time, error) {
 				v = i
 				break
 			}
-			f, err := strconv.ParseFloat(s, 64)
-			if err == nil {
+			f, ok := sql3util.ParseFloat(s)
+			if ok {
 				v = f
 				break
 			}
--- a/util/sql3util/arg.go
+++ b/util/sql3util/arg.go
@@ -1,6 +1,10 @@
 package sql3util

-import "strings"
+import (
+	"strconv"
+	"strings"
+	"time"
+)

 // NamedArg splits an named arg into a key and value,
 // around an equals sign.
@@ -63,3 +67,124 @@ func ParseBool(s string) (b, ok bool) {
 	}
 	return false, false
 }
+
+// ParseFloat parses a decimal floating point number.
+func ParseFloat(s string) (f float64, ok bool) {
+	if strings.TrimLeft(s, "+-.0123456789Ee") != "" {
+		return
+	}
+	f, err := strconv.ParseFloat(s, 64)
+	return f, err == nil
+}
+
+// ParseTimeShift parses a time shift modifier,
+// also the output of timediff.
+//
+// https://sqlite.org/lang_datefunc.html
+func ParseTimeShift(s string) (years, months, days int, duration time.Duration, ok bool) {
+	// Sign part: ±
+	neg := strings.HasPrefix(s, "-")
+	sign := neg || strings.HasPrefix(s, "+")
+	if sign {
+		s = s[1:]
+	}
+
+	if ok = len(s) >= 5; !ok {
+		return // !ok
+	}
+
+	defer func() {
+		if neg {
+			years = -years
+			months = -months
+			days = -days
+			duration = -duration
+		}
+	}()
+
+	// Date part: YYYY-MM-DD
+	if s[4] == '-' {
+		if ok = sign && len(s) >= 10 && s[7] == '-'; !ok {
+			return // !ok
+		}
+		if years, ok = parseInt(s[0:4], 0); !ok {
+			return // !ok
+		}
+		if months, ok = parseInt(s[5:7], 12); !ok {
+			return // !ok
+		}
+		if days, ok = parseInt(s[8:10], 31); !ok {
+			return // !ok
+		}
+		if len(s) == 10 {
+			return
+		}
+		if ok = s[10] == ' '; !ok {
+			return // !ok
+		}
+		s = s[11:]
+	}
+
+	// Time part: HH:MM
+	if ok = len(s) >= 5 && s[2] == ':'; !ok {
+		return // !ok
+	}
+
+	var hours, minutes int
+	if hours, ok = parseInt(s[0:2], 24); !ok {
+		return
+	}
+	if minutes, ok = parseInt(s[3:5], 60); !ok {
+		return
+	}
+	duration = time.Duration(hours)*time.Hour + time.Duration(minutes)*time.Minute
+
+	if len(s) == 5 {
+		return
+	}
+	if ok = len(s) >= 8 && s[5] == ':'; !ok {
+		return // !ok
+	}
+
+	// Seconds part: HH:MM:SS
+	var seconds int
+	if seconds, ok = parseInt(s[6:8], 60); !ok {
+		return
+	}
+	duration += time.Duration(seconds) * time.Second
+
+	if len(s) == 8 {
+		return
+	}
+	if ok = len(s) >= 10 && s[8] == '.'; !ok {
+		return // !ok
+	}
+	s = s[9:]
+
+	// Nanosecond part: HH:MM:SS.SSS
+	var nanos int
+	if nanos, ok = parseInt(s[0:min(9, len(s))], 0); !ok {
+		return
+	}
+	for i := len(s); i < 9; i++ {
+		nanos *= 10
+	}
+	duration += time.Duration(nanos)
+
+	// Subnanosecond part.
+	if len(s) > 9 {
+		_, ok = parseInt(s[9:], 0)
+	}
+	return
+}
+
+func parseInt(s string, max int) (i int, _ bool) {
+	for _, r := range []byte(s) {
+		r -= '0'
+		if r > 9 {
+			return
+		}
+		i = i*10 + int(r)
+	}
+	return i, max == 0 || i < max
+}
--- a/util/sql3util/arg_test.go
+++ b/util/sql3util/arg_test.go
@@ -2,7 +2,10 @@ package sql3util_test

 import (
 	"testing"
+	"time"

+	"github.com/ncruces/go-sqlite3"
+	_ "github.com/ncruces/go-sqlite3/embed"
 	"github.com/ncruces/go-sqlite3/util/sql3util"
 )

@@ -53,3 +56,112 @@ func TestParseBool(t *testing.T) {
 		})
 	}
 }
+
+func TestParseTimeShift(t *testing.T) {
+	epoch := time.Unix(0, 0)
+	tests := []struct {
+		str string
+		val time.Time
+		ok  bool
+	}{
+		{"", epoch, false},
+		{"0001-11-30", epoch, false},
+		{"+_001-11-30", epoch, false},
+		{"+0001-_1-30", epoch.AddDate(1, 0, 0), false},
+		{"+0001-11-_0", epoch.AddDate(1, 11, 0), false},
+		{"+0001-11-30", epoch.AddDate(1, 11, 30), true},
+		{"-0001-11-30", epoch.AddDate(-1, -11, -30), true},
+		{"+0001-11-30T", epoch.AddDate(1, 11, 30), false},
+		{"+0001-11-30 12", epoch.AddDate(1, 11, 30), false},
+		{"+0001-11-30 _2:30", epoch.AddDate(1, 11, 30), false},
+		{"+0001-11-30 12:_0", epoch.AddDate(1, 11, 30), false},
+		{"+0001-11-30 12:30", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute), true},
+		{"+0001-11-30 12:30:", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute), false},
+		{"+0001-11-30 12:30:_0", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute), false},
+		{"+0001-11-30 12:30:59", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second), true},
+		{"+0001-11-30 12:30:59.", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second), false},
+		{"+0001-11-30 12:30:59._", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second), false},
+		{"+0001-11-30 12:30:59.1", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second + 100*time.Millisecond), true},
+		{"+0001-11-30 12:30:59.123456789_", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second + 123456789), false},
+		{"+0001-11-30 12:30:59.1234567890", epoch.AddDate(1, 11, 30).Add(12*time.Hour + 30*time.Minute + 59*time.Second + 123456789), true},
+		{"-12:30:59.1234567890", epoch.Add(-12*time.Hour - 30*time.Minute - 59*time.Second - 123456789), true},
+	}
+	for _, tt := range tests {
+		t.Run(tt.str, func(t *testing.T) {
+			years, months, days, duration, gotOK := sql3util.ParseTimeShift(tt.str)
+			gotVal := epoch.AddDate(years, months, days).Add(duration)
+			if !gotVal.Equal(tt.val) || gotOK != tt.ok {
+				t.Errorf("ParseTimeShift(%q) = (%v, %v) want (%v, %v)", tt.str, gotVal, gotOK, tt.val, tt.ok)
+			}
+		})
+	}
+}
+
+func FuzzParseTimeShift(f *testing.F) {
+	f.Add("")
+	f.Add("0001-12-30")
+	f.Add("+_001-12-30")
+	f.Add("+0001-_2-30")
+	f.Add("+0001-12-_0")
+	f.Add("+0001-12-30")
+	f.Add("-0001-12-30")
+	f.Add("+0001-12-30T")
+	f.Add("+0001-12-30 12")
+	f.Add("+0001-12-30 _2:30")
+	f.Add("+0001-12-30 12:_0")
+	f.Add("+0001-12-30 12:30")
+	f.Add("+0001-12-30 12:30:")
+	f.Add("+0001-12-30 12:30:_0")
+	f.Add("+0001-12-30 12:30:60")
+	f.Add("+0001-12-30 12:30:60.")
+	f.Add("+0001-12-30 12:30:60._")
+	f.Add("+0001-12-30 12:30:60.1")
+	f.Add("+0001-12-30 12:30:60.123456789_")
+	f.Add("+0001-12-30 12:30:60.1234567890")
+	f.Add("-12:30:60.1234567890")
+
+	c, err := sqlite3.Open(":memory:")
+	if err != nil {
+		f.Fatal(err)
+	}
+	defer c.Close()
+
+	s, _, err := c.Prepare(`SELECT julianday('00:00', ?)`)
+	if err != nil {
+		f.Fatal(err)
+	}
+	defer s.Close()
+
+	// Default SQLite date.
+	epoch := time.Date(2000, 1, 1, 0, 0, 0, 0, time.UTC)
+
+	f.Fuzz(func(t *testing.T, str string) {
+		years, months, days, duration, ok := sql3util.ParseTimeShift(str)
+
+		// Account for a full 400 year cycle.
+		if years < -200 || years > +200 {
+			t.Skip()
+		}
+		// SQLite only tracks milliseconds.
+		if duration != duration.Truncate(time.Millisecond) {
+			t.Skip()
+		}
+
+		if ok {
+			s.Reset()
+			s.BindText(1, str)
+			if !s.Step() {
+				t.Fail()
+			}
+
+			got := epoch.AddDate(years, months, days).Add(duration)
+
+			// Julian day introduces floating point inaccuracy.
+			want := s.ColumnTime(0, sqlite3.TimeFormatJulianDay)
+			want = want.Round(time.Millisecond)
+			if !got.Equal(want) {
+				t.Fatalf("with %q, got %v, want %v", str, got, want)
+			}
+		}
+	})
+}
--- a/vfs/memdb/memdb.go
+++ b/vfs/memdb/memdb.go
@@ -223,7 +223,7 @@ func (m *memFile) Lock(lock vfs.LockLevel) error {
 		m.reserved = true

 	case vfs.LOCK_EXCLUSIVE:
-		if m.lock < vfs.LOCK_PENDING {
+		if m.lock == vfs.LOCK_RESERVED {
 			m.lock = vfs.LOCK_PENDING
 			m.pending = true
 		}
--- a/vfs/mvcc/mvcc.go
+++ b/vfs/mvcc/mvcc.go
@@ -252,9 +252,8 @@ func (m *mvccFile) Lock(lock vfs.LockLevel) error {
 		}
 		defer time.AfterFunc(time.Millisecond, m.waiter.Broadcast).Stop()
 		for m.owner != nil {
-			// Our snapshot is invalid.
 			if m.data != nil && m.data != m.mvccDB.data {
-				return sqlite3.BUSY_SNAPSHOT
+				return sqlite3.BUSY_SNAPSHOT // Our snapshot is invalid.
 			}
 			if time.Since(before) > time.Millisecond {
 				return sqlite3.BUSY
@@ -266,17 +265,16 @@ func (m *mvccFile) Lock(lock vfs.LockLevel) error {
 	case m.data == nil:
 		m.data = m.mvccDB.data
 	case m.data != m.mvccDB.data:
-		// Our snapshot is invalid.
-		return sqlite3.BUSY_SNAPSHOT
+		return sqlite3.BUSY_SNAPSHOT // Our snapshot is invalid.
 	}
 	// Take ownership.
-	m.wrflag = false
 	m.lock = lock
 	m.owner = m
 	return nil
 }

 func (m *mvccFile) Unlock(lock vfs.LockLevel) error {
+	m.wrflag = false // SQLite calls unlock even if locking is unsuccessful.
 	if m.lock <= lock {
 		return nil
 	}
@@ -287,7 +285,9 @@ func (m *mvccFile) Unlock(lock vfs.LockLevel) error {
 	// Relase ownership, commit changes.
 	if m.owner == m {
 		m.owner = nil
-		m.mvccDB.data = m.data
+		if m.lock == vfs.LOCK_EXCLUSIVE {
+			m.mvccDB.data = m.data
+		}
 		if m.waiter != nil {
 			m.waiter.Broadcast()
 		}
--- a/vfs/tests/mptest/wasm/mptest.wasm
+++ b/vfs/tests/mptest/wasm/mptest.wasm
--- a/vfs/tests/speedtest1/wasm/speedtest1.wasm
+++ b/vfs/tests/speedtest1/wasm/speedtest1.wasm
--- a/vfs/vfs.go
+++ b/vfs/vfs.go
@@ -329,9 +329,9 @@ func vfsFileControlImpl(ctx context.Context, mod api.Module, file File, op _Fcnt

 	case _FCNTL_PRAGMA:
 		if file, ok := file.(FilePragma); ok {
+			var value string
 			ptr := util.Read32[ptr_t](mod, pArg+1*ptrlen)
 			name := util.ReadString(mod, ptr, _MAX_SQL_LENGTH)
-			var value string
 			if ptr := util.Read32[ptr_t](mod, pArg+2*ptrlen); ptr != 0 {
 				value = util.ReadString(mod, ptr, _MAX_SQL_LENGTH)
 			}
Author	SHA1	Message	Date
Nuno Cruces	0e55451a0b	Deps.	2025-12-19 12:28:57 +00:00
Nuno Cruces	ea9a58ab19	Remove singleflight.	2025-12-17 13:17:50 +00:00
Nuno Cruces	0b46e74ea6	Bump cross-platform-actions/action from 0.30.0 to 0.31.0	2025-12-16 12:34:55 +00:00
Nuno Cruces	8dca850bee	Stricter floats.	2025-12-12 17:21:33 +00:00
Nuno Cruces	5b78823416	ScanColumn dropped.	2025-12-12 13:06:37 +00:00
Nuno Cruces	1764a571da	Litestream v0.5.3.	2025-12-12 12:44:57 +00:00
Nuno Cruces	9837310af7	Fuzz time shift.	2025-12-10 16:15:44 +00:00
dependabot[bot]	ec8961a621	Bump golang.org/x/crypto from 0.45.0 to 0.46.0 (#341 ) Bumps [golang.org/x/crypto](https://github.com/golang/crypto) from 0.45.0 to 0.46.0. - [Commits](https://github.com/golang/crypto/compare/v0.45.0...v0.46.0) --- updated-dependencies: - dependency-name: golang.org/x/crypto dependency-version: 0.46.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2025-12-09 00:49:00 +00:00
Nuno Cruces	8c37aa2d97	Remove inprocess primary.	2025-12-04 16:31:41 +00:00
Nuno Cruces	ca93c498e7	Relative time, fixes.	2025-12-04 15:55:39 +00:00
Nuno Cruces	15e9087fa8	Time travel pragma.	2025-12-03 15:01:04 +00:00
Nuno Cruces	7028e3a5b9	SQLite 3.51.1.	2025-11-30 10:24:34 +00:00
Nuno Cruces	03bb20de6e	Lock tweaks.	2025-11-29 16:12:29 +00:00
Nuno Cruces	20a51a344e	Remove MinLevel.	2025-11-27 17:29:47 +00:00
Nuno Cruces	2dbcc480f7	Initial pragma support.	2025-11-27 16:28:16 +00:00