provide core extension error code logging

Author: stevensJourney

packages/capacitor/src/adapter/CapacitorSQLiteAdapter.ts

@@ -13,6 +13,7 @@ import {
 } from '@powersync/web';
 import Lock from 'async-lock';
 import { PowerSyncCore } from '../plugin/PowerSyncCore';
+import { messageForErrorCode } from '../plugin/PowerSyncPlugin';
 
 /**
  * An implementation of {@link DBAdapter} using the Capacitor Community SQLite [plugin](https://github.com/capacitor-community/sqlite).
@@ -48,8 +49,16 @@ export class CapacitorSQLiteAdapter extends BaseObserver<DBAdapterListener> impl
     return this._readConnection;
   }
 
+  get name() {
+    return this.options.dbFilename;
+  }
+
   private async init() {
-    await PowerSyncCore.registerCore();
+    const { responseCode: registrationResponseCode } = await PowerSyncCore.registerCore();
+    if (registrationResponseCode != 0) {
+      throw new Error(`Could not register PowerSync core extension: ${messageForErrorCode(registrationResponseCode)}`);
+    }
+
     const sqlite = new SQLiteConnection(CapacitorSQLite);
 
     // It seems like the isConnection and retrieveConnection methods
@@ -75,9 +84,6 @@ export class CapacitorSQLiteAdapter extends BaseObserver<DBAdapterListener> impl
     await this.writeConnection.close();
     await this.readConnection.close();
   }
-  get name() {
-    return this.options.dbFilename;
-  }
 
   protected generateLockContext(db: SQLiteDBConnection): LockContext {
     const execute = async (query: string, params: any[] = []): Promise<QueryResult> => {

packages/capacitor/src/plugin/PowerSyncPlugin.ts

@@ -8,6 +8,19 @@ export type RegistrationResponse = {
   responseCode: number;
 };
 
+export const messageForErrorCode = (code: number): string => {
+  switch (code) {
+    case -1:
+      return '[Android] SQLCipher library not found';
+    case -2:
+      return '[Android] Required symbols not found';
+    case 0:
+      return 'Success';
+    default:
+      return `Extension registration failed with SQLite error code: ${code}`;
+  }
+};
+
 export interface PowerSyncPlugin {
   /**
    * Registers the PowerSync core extension with the SQLite library.