Deprecated rawTableNames

.changeset/brown-radios-report.md

@@ -0,0 +1,5 @@
+---
+'@powersync/common': minor
+---
+
+Deprecated `rawTableNames` field in `SQLWatchOptions`. All tables specified in `tables` will now be watched, including PowerSync tables with prefixes.

packages/common/src/client/AbstractPowerSyncDatabase.ts

@@ -79,6 +79,8 @@ export interface SQLWatchOptions {
   /** The minimum interval between queries. */
   throttleMs?: number;
   /**
+   * @deprecated All tables specified in {@link tables} will be watched, including PowerSync tables with prefixes.
+   *
    * Allows for watching any SQL table
    * by not removing PowerSync table name prefixes
    */
@@ -889,7 +891,9 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
     }
 
     const resolvedOptions = options ?? {};
-    const watchedTables = new Set(resolvedOptions.tables ?? []);
+    const watchedTables = new Set<string>(
+      (resolvedOptions?.tables ?? []).flatMap((table) => [table, `ps_data__${table}`, `ps_data_local__${table}`])
+    );
 
     const changedTables = new Set<string>();
     const throttleMs = resolvedOptions.throttleMs ?? DEFAULT_WATCH_THROTTLE_MS;
@@ -910,8 +914,7 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
     const dispose = this.database.registerListener({
       tablesUpdated: async (update) => {
         try {
-          const { rawTableNames } = resolvedOptions;
-          this.processTableUpdates(update, rawTableNames, changedTables);
+          this.processTableUpdates(update, changedTables);
           flushTableUpdates();
         } catch (error) {
           onError?.(error);
@@ -976,24 +979,13 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
 
   private processTableUpdates(
     updateNotification: BatchedUpdateNotification | UpdateNotification,
-    rawTableNames: boolean | undefined,
     changedTables: Set<string>
   ): void {
     const tables = isBatchedUpdateNotification(updateNotification)
       ? updateNotification.tables
       : [updateNotification.table];
 
-    const filteredTables = rawTableNames ? tables : tables.filter((t) => !!t.match(POWERSYNC_TABLE_MATCH));
-    if (!filteredTables.length) {
-      return;
-    }
-
-    // Remove any PowerSync table prefixes if necessary
-    const mappedTableNames = rawTableNames
-      ? filteredTables
-      : filteredTables.map((t) => t.replace(POWERSYNC_TABLE_MATCH, ''));
-
-    for (const table of mappedTableNames) {
+    for (const table of tables) {
       changedTables.add(table);
     }
   }

packages/web/tests/on_change.test.ts

@@ -0,0 +1,66 @@
+import { AbstractPowerSyncDatabase, WatchOnChangeEvent } from '@powersync/common';
+import { PowerSyncDatabase } from '@powersync/web';
+import { v4 as uuid } from 'uuid';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { testSchema } from './utils/testDb';
+vi.useRealTimers();
+
+/**
+ * There seems to be an issue with Vitest browser mode's setTimeout and
+ * fake timer functionality.
+ * e.g. calling:
+ *      await new Promise<void>((resolve) => setTimeout(resolve, 10));
+ * waits for 1 second instead of 10ms.
+ * Setting this to 1 second as a work around.
+ */
+const throttleDuration = 1000;
+
+describe('Watch Tests', () => {
+  let powersync: AbstractPowerSyncDatabase;
+
+  beforeEach(async () => {
+    powersync = new PowerSyncDatabase({
+      database: { dbFilename: 'test-watch.db' },
+      schema: testSchema,
+      flags: {
+        enableMultiTabs: false
+      }
+    });
+  });
+
+  afterEach(async () => {
+    await powersync.disconnectAndClear();
+    await powersync.close();
+  });
+
+  async function runOnChangeTest(tablesToWatch: string[], expectedChangedTables: string[]) {
+    const changedTables: string[] = [];
+    const abortController = new AbortController();
+    const onChange = (event: WatchOnChangeEvent) => {
+      changedTables.push(...event.changedTables);
+    };
+
+    powersync.onChange(
+      { onChange },
+      { tables: tablesToWatch, signal: abortController.signal, throttleMs: throttleDuration }
+    );
+
+    await powersync.execute('INSERT INTO assets(id, make, customer_id) VALUES (uuid(), ?, ?)', ['test', uuid()]);
+    await new Promise<void>((resolve) => setTimeout(resolve, throttleDuration));
+
+    abortController.abort();
+    expect(changedTables).toEqual(expectedChangedTables);
+  }
+
+  it('basic onChange test', async () => {
+    await runOnChangeTest(['assets'], ['ps_data__assets']);
+  });
+
+  it('internal "ps_data" table onChange test', async () => {
+    await runOnChangeTest(['ps_data__assets'], ['ps_data__assets']);
+  });
+
+  it('internal "ps_oplog" table onChange test', async () => {
+    await runOnChangeTest(['ps_oplog'], ['ps_oplog']);
+  });
+});