Skip to content

[Drift] Sync Streams parameter lookups now fail early if count exceeds result-set bound (powersync-service #635) #447

@benitav

Description

@benitav

What's changing: The PowerSync Service now fails early when a Sync Stream parameter query generates too many concurrent lookup requests in a single call. The limit uses the number of lookup results as a generous upper bound. This is most relevant when subscription parameters contain large arrays that fan out into many individual lookups. Previously there was no strict upper bound.

Why this matters for docs: Behavior change — users with Sync Streams configs that pass large arrays as subscription parameters may now encounter new errors that did not occur before; the parameters reference should document this limit and provide guidance on restructuring affected queries.

Likely affected pages/sections:

  • Sync Streams parameters reference (https://docs.powersync.com/sync/streams/parameters.md) — add a note on the parameter lookup request limit: if a subscription parameter (e.g. an array) expands into too many concurrent lookups in a single call, the service fails the request early; recommend keeping array-sourced parameters bounded or splitting into multiple streams if the limit is hit
  • Sync Streams overview or known limitations — add a bullet noting the parameter lookup concurrency cap

Source PR: powersync-ja/powersync-service#635. Note: at the time of filing this issue the PR is open. Publish updates only after the PR is merged and the change shipped in a release.

Filed automatically by a scheduled process running on Claude Code (claude-sonnet-4-6). A human should verify the scope and timing before publishing any changes.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions