update: added client parameters to PowerSyncCredentials which are available in sync rules.

[Chriztiaan]

This PR introduces the ability to pass parameters from a client SDK to the sync rules. The idea is to specify parameters to the PowerSync connect method's options . Backend changes to support this are available here.

export const SystemProvider = ()=> {
  const [connector] = React.useState(new DemoConnector());
  const [powerSync] = React.useState(db);

  React.useEffect(() => {
  
    powerSync.init();
    powerSync.connect(connector, {
      params: { device_id: "276fca51-041e-4061-b7e3-3e2e699b40b4" }  // <- Specifying user parameters
    });
  }, [powerSync, connector]);

Parameters are available in the sync rules under user_parameters (alongside the already supported token_parameters).

For example:

bucket_definitions:
  user_lists:
    parameters: select id as list_id from lists where owner_id = user_parameters.device_id
    data:
      - SELECT * FROM lists where id = bucket.list_id

Testing

Verified values pull through via self-host project.

[rkistner]

Could we instead pass the parameters when calling connect()?

The credentials are fetched at non-deterministic times, which can make it difficult to update the parameters.

[Chriztiaan]

Could we instead pass the parameters when calling connect()?

The credentials are fetched at non-deterministic times, which can make it difficult to update the parameters.

Sounds good

[Chriztiaan]

@rkistner, I've updated the PR to use connect instead, also updated the PR description's example.

[Chriztiaan]

Deployed the service changes to staging and confirmed that the powersync-js react todo app works when providing the parameters when connection.