@powersync/common 1.53.2 → 1.54.0

package/src/client/runOnSchemaChange.ts

@@ -1,5 +1,8 @@
 import { AbstractPowerSyncDatabase, SQLWatchOptions } from './AbstractPowerSyncDatabase.js';
 
+/**
+ * @internal
+ */
 export function runOnSchemaChange(
   callback: (signal: AbortSignal) => void,
   db: AbstractPowerSyncDatabase,

package/src/client/sync/bucket/BucketStorageAdapter.ts

@@ -2,6 +2,9 @@ import { BaseListener, BaseObserverInterface, Disposable } from '../../../utils/
 import { CrudBatch } from './CrudBatch.js';
 import { CrudEntry } from './CrudEntry.js';
 
+/**
+ * @internal
+ */
 export enum PSInternalTable {
   DATA = 'ps_data',
   CRUD = 'ps_crud',
@@ -10,6 +13,9 @@ export enum PSInternalTable {
   UNTYPED = 'ps_untyped'
 }
 
+/**
+ * @internal
+ */
 export enum PowerSyncControlCommand {
   PROCESS_TEXT_LINE = 'line_text',
   PROCESS_BSON_LINE = 'line_binary',
@@ -24,10 +30,16 @@ export enum PowerSyncControlCommand {
   CONNECTION_STATE = 'connection'
 }
 
+/**
+ * @internal
+ */
 export interface BucketStorageListener extends BaseListener {
   crudUpdate: () => void;
 }
 
+/**
+ * @internal
+ */
 export interface BucketStorageAdapter extends BaseObserverInterface<BucketStorageListener>, Disposable {
   init(): Promise<void>;
 

package/src/client/sync/bucket/CrudBatch.ts

@@ -2,6 +2,8 @@ import { CrudEntry } from './CrudEntry.js';
 
 /**
  * A batch of client-side changes.
+ *
+ * @public
  */
 export class CrudBatch {
   constructor(

package/src/client/sync/bucket/CrudEntry.ts

@@ -2,11 +2,15 @@
  * 64-bit unsigned integer stored as a string in base-10.
  *
  * Not sortable as a string.
+ *
+ * @public
  */
 export type OpId = string;
 
 /**
  * Type of local change.
+ *
+ * @public
  */
 export enum UpdateType {
   /** Insert or replace existing row. All non-null columns are included in the data. Generated by INSERT statements. */
@@ -17,6 +21,9 @@ export enum UpdateType {
   DELETE = 'DELETE'
 }
 
+/**
+ * @internal
+ */
 export type CrudEntryJSON = {
   id: string;
   data: string;
@@ -48,6 +55,8 @@ type CrudEntryOutputJSON = {
 
 /**
  * A single client-side change.
+ *
+ * @public
  */
 export class CrudEntry {
   /**

package/src/client/sync/bucket/CrudTransaction.ts

@@ -1,6 +1,9 @@
 import { CrudBatch } from './CrudBatch.js';
 import { CrudEntry } from './CrudEntry.js';
 
+/**
+ * @public
+ */
 export class CrudTransaction extends CrudBatch {
   constructor(
     /**

package/src/client/sync/bucket/SqliteBucketStorage.ts

@@ -11,6 +11,9 @@ import {
 import { CrudBatch } from './CrudBatch.js';
 import { CrudEntry, CrudEntryJSON } from './CrudEntry.js';
 
+/**
+ * @internal
+ */
 export class SqliteBucketStorage extends BaseObserver<BucketStorageListener> implements BucketStorageAdapter {
   public tableNames: Set<string>;
   private updateListener: () => void;

package/src/client/sync/stream/AbstractRemote.ts

@@ -14,6 +14,9 @@ import {
 import { EventIterator } from 'event-iterator';
 import type { Queue } from 'event-iterator/lib/event-iterator.js';
 
+/**
+ * @internal
+ */
 export type RemoteConnector = {
   fetchCredentials: () => Promise<PowerSyncCredentials | null>;
   invalidateCredentials?: () => void;
@@ -36,8 +39,14 @@ const SOCKET_TIMEOUT_MS = 30_000;
 // significantly. Therefore this is longer than the socket timeout.
 const KEEP_ALIVE_LIFETIME_MS = 90_000;
 
+/**
+ * @internal
+ */
 export const DEFAULT_REMOTE_LOGGER = Logger.get('PowerSyncRemote');
 
+/**
+ * @internal
+ */
 export type SyncStreamOptions = {
   path: string;
   data: unknown;
@@ -46,6 +55,9 @@ export type SyncStreamOptions = {
   fetchOptions?: Request;
 };
 
+/**
+ * @public
+ */
 export enum FetchStrategy {
   /**
    * Queues multiple sync events before processing, reducing round-trips.
@@ -60,10 +72,16 @@ export enum FetchStrategy {
   Sequential = 'sequential'
 }
 
+/**
+ * @internal
+ */
 export type SocketSyncStreamOptions = SyncStreamOptions & {
   fetchStrategy: FetchStrategy;
 };
 
+/**
+ * @internal
+ */
 export type FetchImplementation = typeof fetch;
 
 /**
@@ -71,6 +89,8 @@ export type FetchImplementation = typeof fetch;
  * The class wrapper is used to distinguish the fetchImplementation
  * option in [AbstractRemoteOptions] from the general fetch method
  * which is typeof "function"
+ *
+ * @internal
  */
 export class FetchImplementationProvider {
   getFetch(): FetchImplementation {
@@ -78,6 +98,9 @@ export class FetchImplementationProvider {
   }
 }
 
+/**
+ * @internal
+ */
 export type AbstractRemoteOptions = {
   /**
    * Transforms the PowerSync base URL which might contain
@@ -102,6 +125,9 @@ export type AbstractRemoteOptions = {
   fetchOptions?: {};
 };
 
+/**
+ * @internal
+ */
 export const DEFAULT_REMOTE_OPTIONS: AbstractRemoteOptions = {
   socketUrlTransformer: (url) =>
     url.replace(/^https?:\/\//, function (match) {
@@ -111,6 +137,9 @@ export const DEFAULT_REMOTE_OPTIONS: AbstractRemoteOptions = {
   fetchOptions: {}
 };
 
+/**
+ * @internal
+ */
 export abstract class AbstractRemote {
   protected credentials: PowerSyncCredentials | null = null;
   protected options: AbstractRemoteOptions;
@@ -589,7 +618,7 @@ export abstract class AbstractRemote {
    * Posts a `/sync/stream` request.
    *
    * Depending on the `Content-Type` of the response, this returns strings for sync lines or encoded BSON documents as
-   * {@link Uint8Array}s.
+   * `Uint8Array`s.
    */
   async fetchStream(options: SyncStreamOptions): Promise<SimpleAsyncIterator<Uint8Array | string>> {
     const { isBson, stream } = await this.fetchStreamRaw(options);

package/src/client/sync/stream/AbstractStreamingSyncImplementation.ts

@@ -22,16 +22,26 @@ import {
 import { asyncNotifier } from '../../../utils/async.js';
 import { StreamingSyncRequestParameterType } from './JsonValue.js';
 
+/**
+ * @internal
+ */
 export enum LockType {
   CRUD = 'crud',
   SYNC = 'sync'
 }
 
+/**
+ * @public
+ */
 export enum SyncStreamConnectionMethod {
   HTTP = 'http',
   WEB_SOCKET = 'web-socket'
 }
 
+/**
+ * @deprecated Deprecated since {@link SyncClientImplementation.RUST} is the only option.
+ * @public
+ */
 export enum SyncClientImplementation {
   /**
    * This implementation offloads the sync line decoding and handling into the PowerSync
@@ -42,8 +52,8 @@ export enum SyncClientImplementation {
    * ## Compatibility warning
    *
    * The Rust sync client stores sync data in a format that is slightly different than the one used
-   * by the old JavaScript client. When adopting the {@link RUST} client on existing databases, the PowerSync SDK will
-   * migrate the format automatically.
+   * by the old JavaScript client. When adopting the {@link SyncClientImplementation.RUST} client on existing databases,
+   * the PowerSync SDK will migrate the format automatically.
    *
    * SDK versions supporting both the JavaScript and the Rust client support both formats with the JavaScript client
    * implementaiton. However, downgrading to an SDK version that only supports the JavaScript client would not be
@@ -54,11 +64,16 @@ export enum SyncClientImplementation {
 
 /**
  * The default {@link SyncClientImplementation} to use, {@link SyncClientImplementation.RUST}.
+ *
+ * @deprecated Deprecated since {@link SyncClientImplementation.RUST} is the only option.
+ * @public
  */
 export const DEFAULT_SYNC_CLIENT_IMPLEMENTATION = SyncClientImplementation.RUST;
 
 /**
  * Abstract Lock to be implemented by various JS environments
+ *
+ * @internal
  */
 export interface LockOptions<T> {
   callback: () => Promise<T>;
@@ -66,6 +81,9 @@ export interface LockOptions<T> {
   signal?: AbortSignal;
 }
 
+/**
+ * @internal
+ */
 export interface AbstractStreamingSyncImplementationOptions extends RequiredAdditionalConnectionOptions {
   adapter: BucketStorageAdapter;
   subscriptions: SubscribedStream[];
@@ -79,6 +97,9 @@ export interface AbstractStreamingSyncImplementationOptions extends RequiredAddi
   remote: AbstractRemote;
 }
 
+/**
+ * @internal
+ */
 export interface StreamingSyncImplementationListener extends BaseListener {
   /**
    * Triggered whenever a status update has been attempted to be made or
@@ -94,12 +115,17 @@ export interface StreamingSyncImplementationListener extends BaseListener {
 /**
  * Configurable options to be used when connecting to the PowerSync
  * backend instance.
+ *
+ * @public
  */
 export type PowerSyncConnectionOptions = Omit<InternalConnectionOptions, 'serializedSchema'>;
 
+/**
+ * @internal
+ */
 export interface InternalConnectionOptions extends BaseConnectionOptions, AdditionalConnectionOptions {}
 
-/** @internal */
+/** @public */
 export interface BaseConnectionOptions {
   /**
    * A set of metadata to be included in service logs.
@@ -161,6 +187,9 @@ export interface RequiredAdditionalConnectionOptions extends Required<Additional
   subscriptions: SubscribedStream[];
 }
 
+/**
+ * @internal
+ */
 export interface StreamingSyncImplementation
   extends BaseObserverInterface<StreamingSyncImplementationListener>, Disposable {
   /**
@@ -183,16 +212,31 @@ export interface StreamingSyncImplementation
   markConnectionMayHaveChanged(): void;
 }
 
+/**
+ * @internal
+ */
 export const DEFAULT_CRUD_UPLOAD_THROTTLE_MS = 1000;
+/**
+ * @internal
+ */
 export const DEFAULT_RETRY_DELAY_MS = 5000;
 
+/**
+ * @internal
+ */
 export const DEFAULT_STREAMING_SYNC_OPTIONS = {
   retryDelayMs: DEFAULT_RETRY_DELAY_MS,
   crudUploadThrottleMs: DEFAULT_CRUD_UPLOAD_THROTTLE_MS
 };
 
+/**
+ * @internal
+ */
 export type RequiredPowerSyncConnectionOptions = Required<BaseConnectionOptions>;
 
+/**
+ * @internal
+ */
 export const DEFAULT_STREAM_CONNECTION_OPTIONS: RequiredPowerSyncConnectionOptions = {
   appMetadata: {},
   connectionMethod: SyncStreamConnectionMethod.WEB_SOCKET,
@@ -203,11 +247,17 @@ export const DEFAULT_STREAM_CONNECTION_OPTIONS: RequiredPowerSyncConnectionOptio
   includeDefaultStreams: true
 };
 
+/**
+ * @internal
+ */
 export type SubscribedStream = {
   name: string;
   params: Record<string, any> | null;
 };
 
+/**
+ * @internal
+ */
 export abstract class AbstractStreamingSyncImplementation
   extends BaseObserver<StreamingSyncImplementationListener>
   implements StreamingSyncImplementation
@@ -570,7 +620,7 @@ The next upload iteration will be delayed.`);
   }
 
   /**
-   * Older versions of the JS SDK used to encode subkeys as JSON in {@link OplogEntry.toJSON}.
+   * Older versions of the JS SDK used to encode subkeys as JSON in `OplogEntry.toJSON`.
    * Because subkeys are always strings, this leads to quotes being added around them in `ps_oplog`.
    * While this is not a problem as long as it's done consistently, it causes issues when a database
    * created by the JS SDK is used with other SDKs, or (more likely) when the new Rust sync client
@@ -580,7 +630,7 @@ The next upload iteration will be delayed.`);
    * migration is only triggered when necessary (for now). The function returns whether the new format
    * should be used, so that the JS SDK is able to write to updated databases.
    *
-   * @param requireFixedKeyFormat Whether we require the new format or also support the old one.
+   * @param requireFixedKeyFormat - Whether we require the new format or also support the old one.
    *        The Rust client requires the new subkey format.
    * @returns Whether the database is now using the new, fixed subkey format.
    */

package/src/client/sync/stream/JsonValue.ts

@@ -5,4 +5,7 @@ interface JSONObject {
 }
 type JSONArray = JSONValue[];
 
+/**
+ * @public
+ */
 export type StreamingSyncRequestParameterType = JSONValue;

package/src/client/sync/stream/WebsocketClientTransport.ts

@@ -42,7 +42,9 @@ export class WebsocketClientTransport implements ClientTransport {
         resolve(new WebsocketDuplexConnection(websocket, new Deserializer(), multiplexerDemultiplexerFactory));
       };
 
-      const errorListener = (ev: ErrorEvent) => {
+      const errorListener = (event: Event) => {
+        const ev = event as ErrorEvent;
+
         removeListeners();
         // We add a default error in that case.
         if (ev.error != null) {

package/src/client/sync/sync-streams.ts

@@ -1,7 +1,8 @@
-import { AbstractPowerSyncDatabase } from '../AbstractPowerSyncDatabase.js';
-
 /**
- * A description of a sync stream, consisting of its {@link name} and the {@link parameters} used when subscribing.
+ * A description of a sync stream, consisting of its {@link SyncStreamDescription.name} and the
+ * {@link SyncStreamDescription.parameters} used when subscribing.
+ *
+ * @public
  */
 export interface SyncStreamDescription {
   /**
@@ -21,6 +22,8 @@ export interface SyncStreamDescription {
  * Information about a subscribed sync stream.
  *
  * This includes the {@link SyncStreamDescription}, along with information about the current sync status.
+ *
+ * @public
  */
 export interface SyncSubscriptionDescription extends SyncStreamDescription {
   active: boolean;
@@ -28,15 +31,17 @@ export interface SyncSubscriptionDescription extends SyncStreamDescription {
    * Whether this stream subscription is included by default, regardless of whether the stream has explicitly been
    * subscribed to or not.
    *
-   * It's possible for both {@link isDefault} and {@link hasExplicitSubscription} to be true at the same time - this
-   * happens when a default stream was subscribed explicitly.
+   * It's possible for both {@link SyncSubscriptionDescription.isDefault} and
+   * {@link SyncSubscriptionDescription.hasExplicitSubscription} to be true at the same time - this happens when a
+   * default stream was subscribed explicitly.
    */
   isDefault: boolean;
   /**
    * Whether this stream has been subscribed to explicitly.
    *
-   * It's possible for both {@link isDefault} and {@link hasExplicitSubscription} to be true at the same time - this
-   * happens when a default stream was subscribed explicitly.
+   * It's possible for both {@link SyncSubscriptionDescription.isDefault} and
+   * {@link SyncSubscriptionDescription.hasExplicitSubscription} to be true at the same time - this happens when a
+   * default stream was subscribed explicitly.
    */
   hasExplicitSubscription: boolean;
   /**
@@ -49,11 +54,14 @@ export interface SyncSubscriptionDescription extends SyncStreamDescription {
    */
   hasSynced: boolean;
   /**
-   * If {@link hasSynced} is true, the last time data from this stream has been synced.
+   * If {@link SyncSubscriptionDescription.hasSynced} is true, the last time data from this stream has been synced.
    */
   lastSyncedAt: Date | null;
 }
 
+/**
+ * @public
+ */
 export interface SyncStreamSubscribeOptions {
   /**
    * A "time to live" for this stream subscription, in seconds.
@@ -74,6 +82,8 @@ export interface SyncStreamSubscribeOptions {
  * A handle to a {@link SyncStreamDescription} that allows subscribing to the stream.
  *
  * To obtain an instance of {@link SyncStream}, call {@link AbstractPowerSyncDatabase.syncStream}.
+ *
+ * @public
  */
 export interface SyncStream extends SyncStreamDescription {
   /**
@@ -82,7 +92,7 @@ export interface SyncStream extends SyncStreamDescription {
    * You should keep a reference to the returned {@link SyncStreamSubscription} object along as you need data for that
    * stream. As soon as {@link SyncStreamSubscription.unsubscribe} is called for all subscriptions on this stream
    * (including subscriptions created on other tabs), the {@link SyncStreamSubscribeOptions.ttl} starts ticking and will
-   * eventually evict the stream (unless {@link subscribe} is called again).
+   * eventually evict the stream (unless {@link SyncStream.subscribe} is called again).
    */
   subscribe(options?: SyncStreamSubscribeOptions): Promise<SyncStreamSubscription>;
 
@@ -94,6 +104,9 @@ export interface SyncStream extends SyncStreamDescription {
   unsubscribeAll(): Promise<void>;
 }
 
+/**
+ * @public
+ */
 export interface SyncStreamSubscription extends SyncStreamDescription {
   /**
    * A promise that resolves once data from in this sync stream has been synced and applied.

package/src/client/triggers/TriggerManager.ts

@@ -2,7 +2,8 @@ import { LockContext } from '../../db/DBAdapter.js';
 
 /**
  * SQLite operations to track changes for with {@link TriggerManager}
- * @experimental
+ *
+ * @experimental @alpha
  */
 export enum DiffTriggerOperation {
   INSERT = 'INSERT',
@@ -11,7 +12,7 @@ export enum DiffTriggerOperation {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Diffs created by {@link TriggerManager#createDiffTrigger} are stored in a temporary table.
  * This is the base record structure for all diff records.
  *
@@ -42,7 +43,7 @@ export interface BaseTriggerDiffRecord<TOperationId extends string | number = nu
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Represents a diff record for a SQLite UPDATE operation.
  * This record contains the new value and optionally the previous value.
  * Values are stored as JSON strings.
@@ -62,7 +63,7 @@ export interface TriggerDiffUpdateRecord<
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Represents a diff record for a SQLite INSERT operation.
  * This record contains the new value represented as a JSON string.
  */
@@ -77,7 +78,7 @@ export interface TriggerDiffInsertRecord<
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Represents a diff record for a SQLite DELETE operation.
  * This record contains the new value represented as a JSON string.
  */
@@ -92,7 +93,7 @@ export interface TriggerDiffDeleteRecord<
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Diffs created by {@link TriggerManager#createDiffTrigger} are stored in a temporary table.
  * This is the record structure for all diff records.
  *
@@ -121,7 +122,7 @@ export type TriggerDiffRecord<TOperationId extends string | number = number> =
   | TriggerDiffDeleteRecord<TOperationId>;
 
 /**
- * @experimental
+ * @experimental @alpha
  * Querying the DIFF table directly with {@link TriggerDiffHandlerContext#withExtractedDiff} will return records
  * with the tracked columns extracted from the JSON value.
  * This type represents the structure of such records.
@@ -150,7 +151,7 @@ export type ExtractedTriggerDiffRecord<T, TOperationId extends string | number =
 };
 
 /**
- * @experimental
+ * @experimental @alpha
  * Hooks used in the creation of a table diff trigger.
  */
 export interface TriggerCreationHooks {
@@ -213,7 +214,7 @@ interface BaseCreateDiffTriggerOptions {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Options for {@link TriggerManager#createDiffTrigger}.
  */
 export interface CreateDiffTriggerOptions extends BaseCreateDiffTriggerOptions {
@@ -232,7 +233,7 @@ export interface CreateDiffTriggerOptions extends BaseCreateDiffTriggerOptions {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Options for {@link TriggerRemoveCallback}.
  */
 export interface TriggerRemoveCallbackOptions {
@@ -240,12 +241,12 @@ export interface TriggerRemoveCallbackOptions {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Callback to drop a trigger after it has been created.
  */
 export type TriggerRemoveCallback = (options?: TriggerRemoveCallbackOptions) => Promise<void>;
 /**
- * @experimental
+ * @experimental @alpha
  * Options for {@link TriggerDiffHandlerContext#withDiff}.
  */
 export interface WithDiffOptions {
@@ -260,7 +261,7 @@ export interface WithDiffOptions {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Context for the `onChange` handler provided to {@link TriggerManager#trackTableDiff}.
  */
 export interface TriggerDiffHandlerContext extends LockContext {
@@ -317,7 +318,7 @@ export interface TriggerDiffHandlerContext extends LockContext {
    * Allows querying the database with access to the table containing diff records.
    * The diff table is accessible via the `DIFF` accessor.
    *
-   * This is similar to {@link withDiff} but extracts the row columns from the tracked JSON value. The diff operation
+   * This is similar to {@link TriggerDiffHandlerContext#withDiff} but extracts the row columns from the tracked JSON value. The diff operation
    * data is aliased as `__` columns to avoid column conflicts.
    *
    * For {@link DiffTriggerOperation#DELETE} operations the previous_value columns are extracted for convenience.
@@ -349,7 +350,7 @@ export interface TriggerDiffHandlerContext extends LockContext {
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  * Options for tracking changes to a table with {@link TriggerManager#trackTableDiff}.
  */
 export interface TrackDiffOptions extends BaseCreateDiffTriggerOptions {
@@ -361,14 +362,14 @@ export interface TrackDiffOptions extends BaseCreateDiffTriggerOptions {
   onChange: (context: TriggerDiffHandlerContext) => Promise<void>;
 
   /**
-   * The minimum interval, in milliseconds, between {@link onChange} invocations.
+   * The minimum interval, in milliseconds, between {@link TrackDiffOptions.onChange} invocations.
    *  @default {@link DEFAULT_WATCH_THROTTLE_MS}
    */
   throttleMs?: number;
 }
 
 /**
- * @experimental
+ * @experimental @alpha
  */
 export interface TriggerManager {
   /**
@@ -417,7 +418,7 @@ export interface TriggerManager {
   /**
    * @experimental
    * Tracks changes for a table. Triggering a provided handler on changes.
-   * Uses {@link createDiffTrigger} internally to create a temporary destination table.
+   * Uses {@link TriggerManager.createDiffTrigger} internally to create a temporary destination table.
    *
    * @returns A callback to cleanup the trigger and stop tracking changes.
    *

package/src/client/triggers/TriggerManagerImpl.ts

@@ -97,8 +97,8 @@ export class TriggerManagerImpl implements TriggerManager {
     return this.options.db;
   }
 
-  protected async getUUID() {
-    const { id: uuid } = await this.db.get<{ id: string }>(/* sql */ `
+  protected async getUUID(ctx?: LockContext) {
+    const { id: uuid } = await (ctx ?? this.db).get<{ id: string }>(/* sql */ `
       SELECT
         uuid () as id
     `);
@@ -237,7 +237,7 @@ export class TriggerManagerImpl implements TriggerManager {
     const internalSource = sourceDefinition.internalName;
     const triggerIds: string[] = [];
 
-    const id = await this.getUUID();
+    const id = await this.getUUID(setupContext);
 
     const releaseStorageClaim = useStorage ? await this.options.claimManager.obtainClaim(id) : null;
 
@@ -421,7 +421,7 @@ export class TriggerManagerImpl implements TriggerManager {
             const callbackResult = await options.onChange({
               ...tx,
               destinationTable: destination,
-              withDiff: async <T>(query, params, options?: WithDiffOptions) => {
+              withDiff: async <T>(query: string, params: any, options?: WithDiffOptions) => {
                 // Wrap the query to expose the destination table
                 const operationIdSelect = options?.castOperationIdAsText
                   ? 'id, operation, CAST(operation_id AS TEXT) as operation_id, timestamp, value, previous_value'
@@ -439,7 +439,7 @@ export class TriggerManagerImpl implements TriggerManager {
                 `;
                 return tx.getAll<T>(wrappedQuery, params);
               },
-              withExtractedDiff: async <T>(query, params) => {
+              withExtractedDiff: async <T>(query: string, params: any) => {
                 // Wrap the query to expose the destination table
                 const wrappedQuery = /* sql */ `
                   WITH