[Fix] Init Regression

.changeset/itchy-jobs-return.md

@@ -0,0 +1,5 @@
+---
+'@journeyapps/powersync-sdk-common': patch
+---
+
+Fixed regression where `waitForReady` would not trigger or resolve if not invoked before `init`

packages/powersync-sdk-common/src/client/AbstractPowerSyncDatabase.ts

@@ -72,17 +72,18 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
   private abortController: AbortController | null;
   protected bucketStorageAdapter: BucketStorageAdapter;
   private syncStatusListenerDisposer?: () => void;
-  protected _isReadyPromise: Promise<void> | null;
+  protected _isReadyPromise: Promise<void>;
 
   constructor(protected options: PowerSyncDatabaseOptions) {
     super();
-    this._isReadyPromise = null;
     this.bucketStorageAdapter = this.generateBucketStorageAdapter();
     this.closed = true;
     this.currentStatus = null;
     this.options = { ...DEFAULT_POWERSYNC_DB_OPTIONS, ...options };
     this.ready = false;
     this.sdkVersion = '';
+    // Start async init
+    this._isReadyPromise = this.initialize();
   }
 
   get schema() {
@@ -111,34 +112,37 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
       return;
     }
 
-    return (
-      this._isReadyPromise ||
-      (this._isReadyPromise = new Promise((resolve) => {
-        const l = this.registerListener({
-          initialized: () => {
-            this.ready = true;
-            resolve();
-            l?.();
-          }
-        });
-      }))
-    );
+    await this._isReadyPromise;
   }
 
-  abstract _init(): Promise<void>;
+  /**
+   * Allows for extended implementations to execute custom initialization
+   * logic as part of the total init process
+   */
+  abstract _initialize(): Promise<void>;
 
   /**
-   * This performs the total initialization process.
+   * Entry point for executing initialization logic.
+   * This is to be automatically executed in the constructor.
    */
-  async init() {
-    await this._init();
+  protected async initialize() {
+    await this._initialize();
     await this.bucketStorageAdapter.init();
     await this.database.execute('SELECT powersync_replace_schema(?)', [JSON.stringify(this.schema.toJSON())]);
     const version = await this.options.database.execute('SELECT powersync_rs_version()');
     this.sdkVersion = version.rows?.item(0)['powersync_rs_version()'] ?? '';
+    this.ready = true;
     this.iterateListeners((cb) => cb.initialized?.());
   }
 
+  /**
+   * Wait for initialization to complete.
+   * While initializing is automatic, this helps to catch and report initialization errors.
+   */
+  async init() {
+    return this.waitForReady();
+  }
+
   /**
    * Connects to stream of events from PowerSync instance
    */

packages/powersync-sdk-react-native/src/db/PowerSyncDatabase.ts

@@ -9,7 +9,7 @@ import { ReactNativeRemote } from '../sync/stream/ReactNativeRemote';
 import { ReactNativeStreamingSyncImplementation } from '../sync/stream/ReactNativeStreamingSyncImplementation';
 
 export class PowerSyncDatabase extends AbstractPowerSyncDatabase {
-  async _init(): Promise<void> {}
+  async _initialize(): Promise<void> {}
 
   protected generateBucketStorageAdapter(): BucketStorageAdapter {
     return new SqliteBucketStorage(this.database, AbstractPowerSyncDatabase.transactionMutex);

yarn.lock

@@ -2066,13 +2066,6 @@
     "@types/yargs" "^17.0.8"
     chalk "^4.0.0"
 
-"@journeyapps/[email protected]":
-  version "0.1.0"
-  resolved "https://registry.npmjs.org/@journeyapps/react-native-quick-sqlite/-/react-native-quick-sqlite-0.1.0.tgz#51f38f04c477cd8f457465aec48d097d7df85011"
-  integrity sha512-uF1R2RGFXhuY1vvjABAR47kuUSATJmf4RWLmTBHtBa8pLkPh/DKqbvCGhO9lsCC8JDzUfY0+xhsCmnQ4t5trow==
-  dependencies:
-    lodash "^4.17.21"
-
 "@journeyapps/[email protected]":
   version "0.1.1"
   resolved "https://registry.npmjs.org/@journeyapps/react-native-quick-sqlite/-/react-native-quick-sqlite-0.1.1.tgz#94145dba13b177f6aa42552754e56ecc3b2e7f17"