Raw tables

[simolus3]

This adds support for "raw tables", which are managed by the user instead of being created as JSON views by PowerSync. Benefits include better performance for complex queries as well as support for more complex table definitions (including local table and column constraints).

To enable raw tables, one would currently first create a regular schema and then call withRawTables to add them (not sure if we should have a secondary parameter on the Schema constructor for this - perhaps after stabilizing this feature?). Raw tables consist of:

1. A name, identifying the table name used by the sync service (so that the client knows to forward those operations to a raw table).
2. A custom upsert statement to run for PUT ops.
3. A custom delete statement to run for REMOVE ops.

The statements are defined as SQL with prepared statement parameters as well as a value source (which can currently either be the id column or a named column extracted from JSON). The syntax for that is not particularly nice at the moment (it reflects the internal JSON structure used by the core extension). There are multiple options to improve that here, but since the feature is explicitly marked as experimental we can improve on API changes once we better understand how this feature is used in practice.

[changeset-bot]

🦋 Changeset detected

Latest commit: 5369c52

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages

Name	Type
@powersync/common	Minor
@powersync/node	Minor
@powersync/web	Minor
@powersync/react-native	Minor
@powersync/op-sqlite	Patch
@powersync/tanstack-react-query	Patch
@powersync/diagnostics-app	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR