Add SQLite File Inspector to Sync Diagnostics Client by bean1352 · Pull Request #846 · powersync-ja/powersync-js

bean1352 · 2026-02-11T11:17:57Z

Add SQLite File Inspector: upload sqlite files to browse tables, views, indexes, and run SQL queries in-browser (via wa-sqlite MemoryAsyncVFS)
Rewrite DataTable with TanStack Table (pagination, sorting, mobile column hiding, custom cell renderers)
Add shared SQLConsoleCore component with query history (persisted in local DB), auto-LIMIT to prevent UI freezes on large result sets, and a ready prop to defer auto-execution until the database schema is applied
Add shared PowerSyncStats utility for consistent stat computation (Total Rows, Data Size, Metadata Size, CRUD Queue, Buckets) across sync diagnostics and file inspector
Add PowerSync stats cards to inspector overview with compacting/defragmentation alert and CRUD queue warning
Add stream subscription management: unsubscribe button, NewStreamSubscription modal fixes
Add FileDropZone component with drag-and-drop support for the inspector landing page
Consolidate duplicate formatBytes into shared @/lib/utils

…ole features

…k/react-table for data handling. Improved SQL console with auto-limiting feature for query results.

…ole features

…k/react-table for data handling. Improved SQL console with auto-limiting feature for query results.

…hub.com:powersync-ja/powersync-js into feat/refactor-sync-diagnostics-client-inspector

…for deferred query execution and implemented useSchemaReady hook to manage dynamic schema application before executing queries.

changeset-bot · 2026-02-11T11:18:03Z

🦋 Changeset detected

Latest commit: c8619df

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

This PR includes changesets to release 1 package

Name	Type
@powersync/diagnostics-app	Minor

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

…section

…d data handling for sync engine stats. Improved variable naming for clarity.

… errors

stevensJourney

This looks very nice! I left some comments.

stevensJourney · 2026-02-12T08:45:21Z

+      try {
+        // Auto-limit queries without an explicit LIMIT to avoid fetching hundreds of thousands of rows
+        const hasLimit = /\bLIMIT\s+\d+/i.test(sql);
+        const effectiveSql = hasLimit ? sql : `${sql.replace(/;\s*$/, '')} LIMIT ${MAX_RESULT_ROWS + 1}`;


The PR description mentions

auto-LIMIT to prevent UI freezes on large result sets

It looks like the results are displayed in a paged table with a configurable Rows per page. Is it just the fact that having >10_000 rows in memory makes the app slow, or is the table rendering widgets for all items (even those not visible)?

The 10k limit is mainly about memory, holding that many row objects in state slows the app down. Sorting also becomes very compute-heavy with too many rows, since TanStack Table re-sorts the entire dataset on every sort change.

…y-listener

…istoryDropdown

…nect to a PowerSync Instance".

…hub.com:powersync-ja/powersync-js into feat/refactor-sync-diagnostics-client-inspector

…ity and maintainability of sync diagnostics logic.

…ggest performing Compact or Defragment operations for improvement.

…susability.

…ets.

bean1352 · 2026-02-17T12:25:29Z

Created new PR here: #854

bean1352 added 10 commits February 6, 2026 10:39

init

ac1fa77

Added changeset

599e587

Implemented SQLite File Inspector with Inspector Context and SQL Cons…

9513eb1

…ole features

Added PowerSync stats integration and UI improvements. Added @tanstac…

0087f87

…k/react-table for data handling. Improved SQL console with auto-limiting feature for query results.

init

78c6b7f

Implemented SQLite File Inspector with Inspector Context and SQL Cons…

b03e419

…ole features

Added PowerSync stats integration and UI improvements. Added @tanstac…

4407503

…k/react-table for data handling. Improved SQL console with auto-limiting feature for query results.

Merge branch 'feat/refactor-sync-diagnostics-client-inspector' of git…

e70b167

…hub.com:powersync-ja/powersync-js into feat/refactor-sync-diagnostics-client-inspector

Remove unused plugins from Vite config in diagnostics app

6460edd

Added schema readiness feature. Added 'ready' prop to SQLConsoleCore …

555219f

…for deferred query execution and implemented useSchemaReady hook to manage dynamic schema application before executing queries.

bean1352 added 3 commits February 11, 2026 13:22

Revert version downgrade and add changelog

d0a096b

Refactor Vite config by removing empty include array in optimizeDeps …

7380c82

…section

Removed login route. Added confirmation dialog for sign out.

82496a2

bean1352 requested a review from Chriztiaan February 11, 2026 11:38

bean1352 added 2 commits February 11, 2026 15:05

Removed unnecessary comments

2e8350e

Updated README for clarity and added new screenshots

32b2a34

bean1352 marked this pull request as ready for review February 11, 2026 14:16

bean1352 requested a review from stevensJourney February 11, 2026 14:16

bean1352 added 2 commits February 12, 2026 10:03

Updated stat card layout, added tooltips for better context, and adde…

7ae05f6

…d data handling for sync engine stats. Improved variable naming for clarity.

Fix inspector failing to open WAL-mode databases and hanging on query…

7cfde9b

… errors

stevensJourney reviewed Feb 12, 2026

View reviewed changes

bean1352 added 8 commits February 12, 2026 11:50

Added query-history.tsx to split logic out of sql-console-core.tsx

7add752

Move click-away logic into QueryHistoryDropdown using react-click-awa…

734a218

…y-listener

Simplify SQLConsoleCore by moving input and history state into QueryH…

c7761d3

…istoryDropdown

Add JWT token viewer dialog to Sync Diagnostics page

c5f97b5

Show initialization error visually instead of silently proceeding

92cb7f2

Add Monaco editor theming to match dashboard.

21e2a1b

Simplify landing page layout by making connection form the primary focus

44b17d0

Added new landing page screenshot

392eaee

cahofmeyr reviewed Feb 12, 2026

View reviewed changes

Comment thread tools/diagnostics-app/src/routes/index.tsx Outdated

bean1352 and others added 2 commits February 16, 2026 09:27

Update dlanding page title by changing "Connect to PowerSync" to "Con…

d9c2322

…nect to a PowerSync Instance".

Merge branch 'main' into feat/refactor-sync-diagnostics-client-inspector

49618d4

bean1352 requested a review from stevensJourney February 16, 2026 07:45

Chriztiaan requested a review from Manrich121 February 16, 2026 08:14

Manrich121 reviewed Feb 16, 2026

View reviewed changes

bean1352 added 3 commits February 16, 2026 13:15

Add initialization error context and display on landing page

5461055

Updated landing page image to reflect new connect description

898cd1c

Improved row limit handling in sql-console-core.tsx

d8ecac9

Manrich121 reviewed Feb 16, 2026

View reviewed changes

Comment thread .changeset/giant-ways-fix.md Outdated

bean1352 and others added 7 commits February 16, 2026 13:43

Merge branch 'feat/refactor-sync-diagnostics-client-inspector' of git…

82aaf34

…hub.com:powersync-ja/powersync-js into feat/refactor-sync-diagnostics-client-inspector

Introduce a constant for bucket history threshold to improve readabil…

6725446

…ity and maintainability of sync diagnostics logic.

Clarify the impact of accumulated bucket history on sync times and su…

21e771b

…ggest performing Compact or Defragment operations for improvement.

Refactor getTokenUserId function to utilize decodeTokenPayload for re…

1a257db

…susability.

Moved StreamsTable function to a separate file inside components/widg…

2bb3ec7

…ets.

Updated changeset

8f959db

Merge branch 'main' into feat/refactor-sync-diagnostics-client-inspector

c8619df

bean1352 closed this Feb 17, 2026

Conversation

bean1352 commented Feb 11, 2026

Uh oh!

changeset-bot Bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

stevensJourney left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

stevensJourney Feb 12, 2026

Choose a reason for hiding this comment

Uh oh!

bean1352 Feb 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bean1352 commented Feb 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

changeset-bot Bot commented Feb 11, 2026 •

edited

Loading