@powersync/common 0.0.0-dev-20250925184532 → 0.0.0-dev-20251003085035

package/dist/index.d.cts

@@ -1854,6 +1854,8 @@ declare class ConnectionManager extends BaseObserver<ConnectionManagerListener>
      */
     private locallyActiveSubscriptions;
     constructor(options: ConnectionManagerOptions);
+    get connector(): PowerSyncBackendConnector | null;
+    get connectionOptions(): InternalConnectionOptions | null;
     get logger(): ILogger;
     close(): Promise<void>;
     connect(connector: PowerSyncBackendConnector, options: InternalConnectionOptions): Promise<void>;
@@ -1867,7 +1869,13 @@ declare class ConnectionManager extends BaseObserver<ConnectionManagerListener>
     protected disconnectInternal(): Promise<void>;
     protected performDisconnect(): Promise<void>;
     stream(adapter: InternalSubscriptionAdapter, name: string, parameters: Record<string, any> | null): SyncStream;
-    private get activeStreams();
+    /**
+     * @internal exposed for testing
+     */
+    get activeStreams(): {
+        name: string;
+        params: Record<string, any> | null;
+    }[];
     private subscriptionsMayHaveChanged;
 }
 
@@ -2893,6 +2901,18 @@ declare abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncD
     protected connectionManager: ConnectionManager;
     private subscriptions;
     get syncStreamImplementation(): StreamingSyncImplementation | null;
+    /**
+     * The connector used to connect to the PowerSync service.
+     *
+     * @returns The connector used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connector(): PowerSyncBackendConnector | null;
+    /**
+     * The resolved connection options used to connect to the PowerSync service.
+     *
+     * @returns The resolved connection options used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connectionOptions(): InternalConnectionOptions | null;
     protected _schema: Schema;
     private _database;
     protected runExclusiveMutex: Mutex;
@@ -2946,7 +2966,10 @@ declare abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncD
         signal?: AbortSignal;
         priority?: number;
     }): Promise<void>;
-    private waitForStatus;
+    /**
+     * Waits for the first sync status for which the `status` callback returns a truthy value.
+     */
+    waitForStatus(predicate: (status: SyncStatus) => any, signal?: AbortSignal): Promise<void>;
     /**
      * Allows for extended implementations to execute custom initialization
      * logic as part of the total init process

package/lib/client/AbstractPowerSyncDatabase.d.ts

@@ -12,7 +12,7 @@ import { PowerSyncBackendConnector } from './connection/PowerSyncBackendConnecto
 import { BucketStorageAdapter } from './sync/bucket/BucketStorageAdapter.js';
 import { CrudBatch } from './sync/bucket/CrudBatch.js';
 import { CrudTransaction } from './sync/bucket/CrudTransaction.js';
-import { StreamingSyncImplementation, StreamingSyncImplementationListener, type AdditionalConnectionOptions, type PowerSyncConnectionOptions, type RequiredAdditionalConnectionOptions } from './sync/stream/AbstractStreamingSyncImplementation.js';
+import { InternalConnectionOptions, StreamingSyncImplementation, StreamingSyncImplementationListener, type AdditionalConnectionOptions, type PowerSyncConnectionOptions, type RequiredAdditionalConnectionOptions } from './sync/stream/AbstractStreamingSyncImplementation.js';
 import { TriggerManager } from './triggers/TriggerManager.js';
 import { WatchCompatibleQuery } from './watched/WatchedQuery.js';
 import { WatchedQueryComparator } from './watched/processors/comparators.js';
@@ -132,6 +132,18 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
     protected connectionManager: ConnectionManager;
     private subscriptions;
     get syncStreamImplementation(): StreamingSyncImplementation | null;
+    /**
+     * The connector used to connect to the PowerSync service.
+     *
+     * @returns The connector used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connector(): PowerSyncBackendConnector | null;
+    /**
+     * The resolved connection options used to connect to the PowerSync service.
+     *
+     * @returns The resolved connection options used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connectionOptions(): InternalConnectionOptions | null;
     protected _schema: Schema;
     private _database;
     protected runExclusiveMutex: Mutex;
@@ -185,7 +197,10 @@ export declare abstract class AbstractPowerSyncDatabase extends BaseObserver<Pow
         signal?: AbortSignal;
         priority?: number;
     }): Promise<void>;
-    private waitForStatus;
+    /**
+     * Waits for the first sync status for which the `status` callback returns a truthy value.
+     */
+    waitForStatus(predicate: (status: SyncStatus) => any, signal?: AbortSignal): Promise<void>;
     /**
      * Allows for extended implementations to execute custom initialization
      * logic as part of the total init process

package/lib/client/AbstractPowerSyncDatabase.js

@@ -63,6 +63,22 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
     get syncStreamImplementation() {
         return this.connectionManager.syncStreamImplementation;
     }
+    /**
+     * The connector used to connect to the PowerSync service.
+     *
+     * @returns The connector used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connector() {
+        return this.connectionManager.connector;
+    }
+    /**
+     * The resolved connection options used to connect to the PowerSync service.
+     *
+     * @returns The resolved connection options used to connect to the PowerSync service or null if `connect()` has not been called.
+     */
+    get connectionOptions() {
+        return this.connectionManager.connectionOptions;
+    }
     _schema;
     _database;
     runExclusiveMutex;
@@ -188,6 +204,9 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
             : (status) => status.statusForPriority(priority).hasSynced;
         return this.waitForStatus(statusMatches, signal);
     }
+    /**
+     * Waits for the first sync status for which the `status` callback returns a truthy value.
+     */
     async waitForStatus(predicate, signal) {
         if (predicate(this.currentStatus)) {
             return;
@@ -196,15 +215,20 @@ export class AbstractPowerSyncDatabase extends BaseObserver {
             const dispose = this.registerListener({
                 statusChanged: (status) => {
                     if (predicate(status)) {
-                        dispose();
-                        resolve();
+                        abort();
                     }
                 }
             });
-            signal?.addEventListener('abort', () => {
+            function abort() {
                 dispose();
                 resolve();
-            });
+            }
+            if (signal?.aborted) {
+                abort();
+            }
+            else {
+                signal?.addEventListener('abort', abort);
+            }
         });
     }
     /**

package/lib/client/ConnectionManager.d.ts

@@ -85,6 +85,8 @@ export declare class ConnectionManager extends BaseObserver<ConnectionManagerLis
      */
     private locallyActiveSubscriptions;
     constructor(options: ConnectionManagerOptions);
+    get connector(): PowerSyncBackendConnector | null;
+    get connectionOptions(): InternalConnectionOptions | null;
     get logger(): ILogger;
     close(): Promise<void>;
     connect(connector: PowerSyncBackendConnector, options: InternalConnectionOptions): Promise<void>;
@@ -98,7 +100,13 @@ export declare class ConnectionManager extends BaseObserver<ConnectionManagerLis
     protected disconnectInternal(): Promise<void>;
     protected performDisconnect(): Promise<void>;
     stream(adapter: InternalSubscriptionAdapter, name: string, parameters: Record<string, any> | null): SyncStream;
-    private get activeStreams();
+    /**
+     * @internal exposed for testing
+     */
+    get activeStreams(): {
+        name: string;
+        params: Record<string, any> | null;
+    }[];
     private subscriptionsMayHaveChanged;
 }
 export {};

package/lib/client/ConnectionManager.js

@@ -48,6 +48,12 @@ export class ConnectionManager extends BaseObserver {
         this.syncStreamImplementation = null;
         this.syncDisposer = null;
     }
+    get connector() {
+        return this.pendingConnectionOptions?.connector ?? null;
+    }
+    get connectionOptions() {
+        return this.pendingConnectionOptions?.options ?? null;
+    }
     get logger() {
         return this.options.logger;
     }
@@ -224,13 +230,14 @@ export class ConnectionManager extends BaseObserver {
             }
         };
     }
+    /**
+     * @internal exposed for testing
+     */
     get activeStreams() {
         return [...this.locallyActiveSubscriptions.values()].map((a) => ({ name: a.name, params: a.parameters }));
     }
     subscriptionsMayHaveChanged() {
-        if (this.syncStreamImplementation) {
-            this.syncStreamImplementation.updateSubscriptions(this.activeStreams);
-        }
+        this.syncStreamImplementation?.updateSubscriptions(this.activeStreams);
     }
 }
 class ActiveSubscription {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "0.0.0-dev-20250925184532",
+  "version": "0.0.0-dev-20251003085035",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"