fabc9062cb
src/db/sqlite.sx grows from the P5.1 subset (~19 fns) to the complete practical surface (~100): open_v2 + flags, extended errcodes + error_offset, txn_state/autocommit, changes64/total_changes64, limits, the full bind/column families (double/blob/zeroblob), parameter and column introspection (built with SQLITE_ENABLE_COLUMN_METADATA), table_column_metadata, statement introspection (sql/expanded_sql/ readonly/busy/isexplain/status), incremental blob I/O (SqliteBlob), online backup (SqliteBackup + sqlite_backup_run), serialize/ deserialize, and library utilities (complete, strglob/strlike/stricmp, randomness, memory, compileoptions). One variant per duplicate family (modern/64-bit preferred; bind_text/blob keep the 32-bit length forms that skip text64's encoding arg). Not bound, by design: callback-taking APIs (hooks/UDFs/collations need C->sx callbacks), sqlite3_value_* (UDF-coupled), varargs config, UTF-16, and subsystems this build omits — the boundary list lives in the module header and vendor README. rename.h is now GENERATED by make into build/vendor/ from the bindings' #foreign names — src/db/sqlite.sx is the single source of truth and the rename list cannot drift (checked-in vendor/sqlite/rename.h removed). make test 21/21 (new: sqlite_api.sx — 15 cases over every wrapper family, including a blob round trip with interior NULs, UNIQUE constraint extended errcodes, txn_state through BEGIN IMMEDIATE, backup db->db, and a serialize->deserialize round trip). KNOWN sx BOUNDARY (filed as a followup): 'if !e' on an error binding evaluates true even when the error is set — negated error logic in tests routes through plain bools.
Vendored SQLite
- Version: 3.53.2 (
SQLITE_VERSIONinsqlite3.h) - Source: https://sqlite.org/2026/sqlite-amalgamation-3530200.zip
- Zip sha256:
8a310d0a16c7a90cacd4c884e70faa51c902afed2a89f63aaa0126ab83558a32 - Files kept:
sqlite3.c,sqlite3.h(the amalgamation;shell.candsqlite3ext.hdropped — no shell, no loadable extensions) - License: public domain (https://sqlite.org/copyright.html)
make build compiles this into build/vendor/libsqlite3.a (statically
linked into the dist binary via -L build/vendor) and
build/vendor/jit/libsqlite3.dylib (dlopen'd by sx run, which is how
make test executes the test programs). The two locations are separate
on purpose: the macOS linker prefers a dylib over an archive in the same
search directory, and the AOT binary must link the static copy.
tests/sqlite_smoke.sx asserts sqlite3_libversion() equals the version
above, so a fallback to the OS libsqlite3 fails loudly in both modes.
Symbol renaming
The sx JIT resolves #foreign symbols via dlsym(RTLD_DEFAULT), which
searches every image already loaded into the process — the OS libsqlite3
is usually among them and wins by load order. So every API function the
bindings use is renamed dist_sqlite3_* in the vendored build: those
symbols exist ONLY here, making resolution unambiguous in both JIT and
AOT modes. The rename header is GENERATED by make into
build/vendor/rename.h from the #foreign names in
src/db/sqlite.sx — the bindings file is the single source of truth,
and the rename list cannot drift from it.
Bound surface
src/db/sqlite.sx maps the full practical C API (~100 functions):
connection lifecycle + open_v2 flags, errors (extended codes included),
statements with the complete bind/column families, parameter and column
introspection (built with SQLITE_ENABLE_COLUMN_METADATA), incremental
blob I/O, the online backup API, serialize/deserialize, and the library
utilities. Not bound, by design: callback-taking APIs (hooks, UDFs,
collations, authorizers — they need C→sx callbacks), the
sqlite3_value_* family (UDF-coupled), varargs configuration, UTF-16
variants, and subsystems this build omits (mutex/VFS under
SQLITE_THREADSAFE=0, sessions/snapshots/vtabs, deprecated API).
To upgrade: replace sqlite3.c/sqlite3.h with a newer amalgamation,
update this file and the version constant in tests/sqlite_smoke.sx, and
run make clean test.