Upgrading

[alxndrsn]

Hi, I've searched the docs & discussions and I can't find any notes on upgrading better-sqlite3 versions. Are there any specific guidelines? Should there ever be issues, e.g. going from v8 -> v11?

[mceachen]

You can skim the releases, but for as long as I’ve been involved with this project (4+ years), I can’t remember a breaking API change.

I update the major version number when versions of Node.js are dropped from support, and when SQLite changes seem substantial enough to warrant caution (but again, the changes they make are overwhelmingly forward compatible).

[alxndrsn]

I've skimmed release notes, and couldn't see any likely issues.

My main concern is actually about SQLite changes, and compatibility with existing databases.

[mceachen]

As far as I know and have tested, the file format on disk used by SQLite is extremely stable.

There are some newer features that older SQLite engines won’t be able to read and obey (like STRICT and FTS5) but, most importantly, newer versions of SQLite3 can always read databases written by older versions of SQLite3 (in my experience).

[alxndrsn]

Would there be support for adding a section to the README or other docs, e.g.

Upgrading

Upgrading your better-sqlite3 dependency can potentially introduce breaking changes, either in the better-sqlite3 API, or between your existing database(s) and the underlying version of SQLite. Before upgrading, review:

• better-sqlite3 release notes: https://github.com/WiseLibs/better-sqlite3/releases
• SQLite changelog: https://www.sqlite.org/changes.html

[mceachen]

That’d be a great addition, I think.