@powersync/common 1.25.0 → 1.27.0

package/lib/client/AbstractPowerSyncDatabase.d.ts

@@ -265,6 +265,7 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
      * and optionally return results.
      */
     execute(sql: string, parameters?: any[]): Promise<QueryResult>;
+    executeRaw(sql: string, parameters?: any[]): Promise<any[][]>;
     /**
      * Execute a write query (INSERT/UPDATE/DELETE) multiple times with each parameter set
      * and optionally return results.

package/lib/client/AbstractPowerSyncDatabase.js

@@ -459,6 +459,10 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
         await this.waitForReady();
         return this.database.execute(sql, parameters);
     }
+    async executeRaw(sql, parameters) {
+        await this.waitForReady();
+        return this.database.executeRaw(sql, parameters);
+    }
     /**
      * Execute a write query (INSERT/UPDATE/DELETE) multiple times with each parameter set
      * and optionally return results.

package/lib/client/SQLOpenFactory.d.ts

@@ -6,6 +6,9 @@ export interface SQLOpenOptions {
     dbFilename: string;
     /**
      * Directory where the database file is located.
+     *
+     * When set, the directory must exist when the database is opened, it will
+     * not be created automatically.
      */
     dbLocation?: string;
     /**

package/lib/client/sync/stream/AbstractStreamingSyncImplementation.js

@@ -148,6 +148,11 @@ The next upload iteration will be delayed.`);
                             }
                             checkedCrudItem = nextCrudItem;
                             await this.options.uploadCrud();
+                            this.updateSyncStatus({
+                                dataFlow: {
+                                    uploadError: undefined
+                                }
+                            });
                         }
                         else {
                             // Uploading is completed
@@ -159,7 +164,8 @@ The next upload iteration will be delayed.`);
                         checkedCrudItem = undefined;
                         this.updateSyncStatus({
                             dataFlow: {
-                                uploading: false
+                                uploading: false,
+                                uploadError: ex
                             }
                         });
                         await this.delayRetry();
@@ -300,6 +306,11 @@ The next upload iteration will be delayed.`);
                 else {
                     this.logger.error(ex);
                 }
+                this.updateSyncStatus({
+                    dataFlow: {
+                        downloadError: ex
+                    }
+                });
                 // On error, wait a little before retrying
                 await this.delayRetry();
             }
@@ -422,7 +433,8 @@ The next upload iteration will be delayed.`);
                                 connected: true,
                                 lastSyncedAt: new Date(),
                                 dataFlow: {
-                                    downloading: false
+                                    downloading: false,
+                                    downloadError: undefined
                                 }
                             });
                         }
@@ -520,7 +532,10 @@ The next upload iteration will be delayed.`);
                             this.updateSyncStatus({
                                 connected: true,
                                 lastSyncedAt: new Date(),
-                                priorityStatusEntries: []
+                                priorityStatusEntries: [],
+                                dataFlow: {
+                                    downloadError: undefined
+                                }
                             });
                         }
                         else if (validatedCheckpoint === targetCheckpoint) {
@@ -542,7 +557,8 @@ The next upload iteration will be delayed.`);
                                     lastSyncedAt: new Date(),
                                     priorityStatusEntries: [],
                                     dataFlow: {
-                                        downloading: false
+                                        downloading: false,
+                                        downloadError: undefined
                                     }
                                 });
                             }

package/lib/db/DBAdapter.d.ts

@@ -39,6 +39,21 @@ export interface DBGetUtils {
 export interface LockContext extends DBGetUtils {
     /** Execute a single write statement. */
     execute: (query: string, params?: any[] | undefined) => Promise<QueryResult>;
+    /**
+     * Execute a single write statement and return raw results.
+     * Unlike `execute`, which returns an object with structured key-value pairs,
+     * `executeRaw` returns a nested array of raw values, where each row is
+     * represented as an array of column values without field names.
+     *
+     * Example result:
+     *
+     * ```[ [ '1', 'list 1', '33', 'Post content', '1' ] ]```
+     *
+     * Where as `execute`'s `rows._array` would have been:
+     *
+     * ```[ { id: '33', name: 'list 1', content: 'Post content', list_id: '1' } ]```
+     */
+    executeRaw: (query: string, params?: any[] | undefined) => Promise<any[][]>;
 }
 export interface Transaction extends LockContext {
     /** Commit multiple changes to the local DB using the Transaction context. */
@@ -84,6 +99,7 @@ export interface DBLockOptions {
 export interface DBAdapter extends BaseObserverInterface<DBAdapterListener>, DBGetUtils {
     close: () => void | Promise<void>;
     execute: (query: string, params?: any[]) => Promise<QueryResult>;
+    executeRaw: (query: string, params?: any[]) => Promise<any[][]>;
     executeBatch: (query: string, params?: any[][]) => Promise<QueryResult>;
     name: string;
     readLock: <T>(fn: (tx: LockContext) => Promise<T>, options?: DBLockOptions) => Promise<T>;

package/lib/db/crud/SyncStatus.d.ts

@@ -1,6 +1,17 @@
 export type SyncDataFlowStatus = Partial<{
     downloading: boolean;
     uploading: boolean;
+    /**
+     * Error during downloading (including connecting).
+     *
+     * Cleared on the next successful data download.
+     */
+    downloadError?: Error;
+    /**
+     * Error during uploading.
+     * Cleared on the next successful upload.
+     */
+    uploadError?: Error;
 }>;
 export interface SyncPriorityStatus {
     priority: number;
@@ -39,6 +50,17 @@ export declare class SyncStatus {
     get dataFlowStatus(): Partial<{
         downloading: boolean;
         uploading: boolean;
+        /**
+         * Error during downloading (including connecting).
+         *
+         * Cleared on the next successful data download.
+         */
+        downloadError?: Error;
+        /**
+         * Error during uploading.
+         * Cleared on the next successful upload.
+         */
+        uploadError?: Error;
     }>;
     /**
      * Partial sync status for involved bucket priorities.

package/lib/db/crud/SyncStatus.js

@@ -83,7 +83,7 @@ export class SyncStatus {
     }
     getMessage() {
         const dataFlow = this.dataFlowStatus;
-        return `SyncStatus<connected: ${this.connected} connecting: ${this.connecting} lastSyncedAt: ${this.lastSyncedAt} hasSynced: ${this.hasSynced}. Downloading: ${dataFlow.downloading}. Uploading: ${dataFlow.uploading}`;
+        return `SyncStatus<connected: ${this.connected} connecting: ${this.connecting} lastSyncedAt: ${this.lastSyncedAt} hasSynced: ${this.hasSynced}. Downloading: ${dataFlow.downloading}. Uploading: ${dataFlow.uploading}. UploadError: ${dataFlow.uploadError}, DownloadError?: ${dataFlow.downloadError}>`;
     }
     toJSON() {
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "1.25.0",
+  "version": "1.27.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"