Skip to content

[Drift] Web worker paths consolidated and UMD build removed in JS SDK v2 (powersync-js #1008) #520

Description

@benitav

What's changing: The web SDK merges its database and sync workers into a single file and removes the UMD build. Custom worker users must update paths from /@powersync/worker/WASQLiteDB.umd.js and /@powersync/worker/SharedSyncImplementation.umd.js to /@powersync/worker.js. React Native Web users must stop importing @powersync/web/umd and import @powersync/web directly.

High priority — existing docs are now inaccurate or incomplete

  • React Native Web support page (/client-sdks/frameworks/react-native-web-support) — currently shows '/@powersync/worker/WASQLiteDB.umd.js' as the database worker path and '/@powersync/worker/SharedSyncImplementation.umd.js' as the sync worker path, and has a section instructing users to configure @powersync/web/umd as the UMD target. In v2, the correct path for both workers is /@powersync/worker.js and @powersync/web/umd no longer exists.
  • Next.js page (/client-sdks/frameworks/next-js) — the initialization example sets worker: '/@powersync/worker/WASQLiteDB.umd.js' and sync: { worker: '/@powersync/worker/SharedSyncImplementation.umd.js' }. Both paths are removed in v2.

For reviewer consideration — may be worth documenting
None.

Source PR: powersync-ja/powersync-js#1008 — merged to the v2 pre-release branch on 2026-06-25. This change has not shipped in a stable release.

Filed automatically by Claude Code (claude-sonnet-4-6). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions