@powersync/common 0.0.0-dev-20250922105207 → 0.0.0-dev-20250922105508

package/lib/db/crud/SyncStatus.js

@@ -4,6 +4,15 @@ export class SyncStatus {
     constructor(options) {
         this.options = options;
     }
+    /**
+     * Returns the used sync client implementation (either the one implemented in JavaScript or the newer Rust-based
+     * implementation).
+     *
+     * This information is only available after a connection has been requested.
+     */
+    get clientImplementation() {
+        return this.options.clientImplementation;
+    }
     /**
      * Indicates if the client is currently connected to the PowerSync service.
      *
@@ -59,6 +68,27 @@ export class SyncStatus {
             uploading: false
         });
     }
+    /**
+     * All sync streams currently being tracked in teh database.
+     *
+     * This returns null when the database is currently being opened and we don't have reliable information about all
+     * included streams yet.
+     *
+     * @experimental Sync streams are currently in alpha.
+     */
+    get syncStreams() {
+        return this.options.dataFlow?.internalStreamSubscriptions?.map((core) => new SyncStreamStatusView(this, core));
+    }
+    /**
+     * If the `stream` appears in {@link syncStreams}, returns the current status for that stream.
+     *
+     * @experimental Sync streams are currently in alpha.
+     */
+    forStream(stream) {
+        const asJson = JSON.stringify(stream.parameters);
+        const raw = this.options.dataFlow?.internalStreamSubscriptions?.find((r) => r.name == stream.name && asJson == JSON.stringify(r.parameters));
+        return raw && new SyncStreamStatusView(this, raw);
+    }
     /**
      * Provides sync status information for all bucket priorities, sorted by priority (highest first).
      *
@@ -168,3 +198,34 @@ export class SyncStatus {
         return b.priority - a.priority; // Reverse because higher priorities have lower numbers
     }
 }
+class SyncStreamStatusView {
+    status;
+    core;
+    subscription;
+    constructor(status, core) {
+        this.status = status;
+        this.core = core;
+        this.subscription = {
+            name: core.name,
+            parameters: core.parameters,
+            active: core.active,
+            isDefault: core.is_default,
+            hasExplicitSubscription: core.has_explicit_subscription,
+            expiresAt: core.expires_at != null ? new Date(core.expires_at * 1000) : null,
+            hasSynced: core.last_synced_at != null,
+            lastSyncedAt: core.last_synced_at != null ? new Date(core.last_synced_at * 1000) : null
+        };
+    }
+    get progress() {
+        if (this.status.dataFlowStatus.downloadProgress == null) {
+            // Don't make download progress public if we're not currently downloading.
+            return null;
+        }
+        const { total, downloaded } = this.core.progress;
+        const progress = total == 0 ? 0.0 : downloaded / total;
+        return { totalOperations: total, downloadedOperations: downloaded, downloadedFraction: progress };
+    }
+    get priority() {
+        return this.core.priority;
+    }
+}

package/lib/index.d.ts

@@ -18,6 +18,7 @@ export * from './client/sync/bucket/SyncDataBucket.js';
 export * from './client/sync/stream/AbstractRemote.js';
 export * from './client/sync/stream/AbstractStreamingSyncImplementation.js';
 export * from './client/sync/stream/streaming-sync-types.js';
+export * from './client/sync/sync-streams.js';
 export * from './client/ConnectionManager.js';
 export { ProgressWithOperations, SyncProgress } from './db/crud/SyncProgress.js';
 export * from './db/crud/SyncStatus.js';

package/lib/index.js

@@ -18,6 +18,7 @@ export * from './client/sync/bucket/SyncDataBucket.js';
 export * from './client/sync/stream/AbstractRemote.js';
 export * from './client/sync/stream/AbstractStreamingSyncImplementation.js';
 export * from './client/sync/stream/streaming-sync-types.js';
+export * from './client/sync/sync-streams.js';
 export * from './client/ConnectionManager.js';
 export { SyncProgress } from './db/crud/SyncProgress.js';
 export * from './db/crud/SyncStatus.js';

package/package.json

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