Fix typo + rethrow unhelpful error

Author: LucDeCaf

PowerSync/PowerSync.Common/CHANGELOG.md

@@ -6,7 +6,7 @@
 - Add support for .NET 9.0. Supported targets now also include `net9.0`, `net9.0-android`, `net9.0-ios`, and `net9.0-maccatalyst`.
 - Update the PowerSync SQLite core extension to 0.4.13.
 - Add support for offline-first file attachments via `AttachmentQueue`. See `Attachments/README.md`.
-- Add support for loading custom SQLite extensions via `MDSqliteOptions.Extensions`.
+- Add support for loading custom SQLite extensions via `MDSQLiteOptions.Extensions`.
 
 ## 0.1.1
 

PowerSync/PowerSync.Common/MDSQLite/MDSQLiteAdapter.cs

@@ -129,7 +129,22 @@ protected async Task<MDSQLiteConnection> OpenConnection(string dbFilename)
         LoadExtensions(db);
 
         var connection = new MDSQLiteConnection(new MDSQLiteConnectionOptions(db));
-        await connection.Execute("SELECT powersync_init()");
+        try
+        {
+            await connection.Execute("SELECT powersync_init()");
+        }
+        catch (SqliteException ex)
+        {
+            // SQLite will throw a very unhelpful "SQLite Error 1: 'The specified
+            // module could not be found.'" error if uncaught.
+            throw new SqliteException(
+                "Failed to initialize PowerSync: powersync_init() is not registered. " +
+                "Ensure the PowerSync core SQLite extension is loaded. Either set " +
+                "MDSQLiteOptions.LoadPowerSyncExtension to true (default), or supply " +
+                "a PowerSync-compatible extension via MDSQLiteOptions.Extensions.",
+                ex.SqliteErrorCode,
+                ex.SqliteExtendedErrorCode);
+        }
 
         return connection;
     }