chore: deprecate dev connector (#59)

Co-authored-by: DominicGBauer <[email protected]>

Author: DominicGBauer

demos/supabase-anonymous-auth/pubspec.lock

@@ -310,7 +310,7 @@ packages:
       path: "../../packages/powersync"
       relative: true
     source: path
-    version: "1.2.0"
+    version: "1.2.2"
   realtime_client:
     dependency: transitive
     description:

demos/supabase-edge-function-auth/pubspec.lock

@@ -310,7 +310,7 @@ packages:
       path: "../../packages/powersync"
       relative: true
     source: path
-    version: "1.2.0"
+    version: "1.2.2"
   realtime_client:
     dependency: transitive
     description:

demos/supabase-simple-chat/pubspec.lock

@@ -326,7 +326,7 @@ packages:
       path: "../../packages/powersync"
       relative: true
     source: path
-    version: "1.2.0"
+    version: "1.2.2"
   realtime_client:
     dependency: transitive
     description:

demos/supabase-todolist/pubspec.lock

@@ -414,7 +414,7 @@ packages:
       path: "../../packages/powersync"
       relative: true
     source: path
-    version: "1.2.0"
+    version: "1.2.2"
   powersync_attachments_helper:
     dependency: "direct main"
     description:

packages/powersync/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.2.2
+
+- Deprecate DevConnector and related
+
 ## 1.2.1
 
 - Fix indexes incorrectly dropped after the first run.

packages/powersync/lib/src/connector.dart

@@ -11,9 +11,6 @@ import 'powersync_database.dart';
 /// 1. Creating credentials for connecting to the PowerSync service.
 /// 2. Applying local changes against the backend application server.
 ///
-/// [DevConnector] is provided as a quick starting point, without user management
-/// or significant security.
-///
 /// For production, use a custom implementation.
 abstract class PowerSyncBackendConnector {
   PowerSyncCredentials? _cachedCredentials;
@@ -67,7 +64,7 @@ abstract class PowerSyncBackendConnector {
 
   /// Upload local changes to the app backend.
   ///
-  /// Use [PowerSyncDatabase.getCrudBatch] to get a batch of changes to upload. See [DevConnector] for an example implementation.
+  /// Use [PowerSyncDatabase.getCrudBatch] to get a batch of changes to upload.
   ///
   /// Any thrown errors will result in a retry after the configured wait period (default: 5 seconds).
   Future<void> uploadData(PowerSyncDatabase database);
@@ -153,6 +150,7 @@ class PowerSyncCredentials {
 ///
 /// These cannot be used for the main PowerSync APIs. [DevConnector] uses these
 /// credentials to automatically fetch [PowerSyncCredentials].
+@Deprecated('We will be removing this in version 2.')
 class DevCredentials {
   /// Dev endpoint.
   String endpoint;
@@ -201,6 +199,7 @@ class DevCredentials {
 ///
 /// Development mode is intended to get up and running quickly, but is not for
 /// production use. For production, write a custom connector.
+@Deprecated('We will be removing this in version 2.')
 class DevConnector extends PowerSyncBackendConnector {
   DevCredentials? _inMemoryDevCredentials;
 

packages/powersync/lib/src/open_factory.dart

@@ -24,13 +24,13 @@ class SqliteConnectionSetup {
 }
 
 class PowerSyncOpenFactory extends DefaultSqliteOpenFactory {
-  @Deprecated('Override PowerSyncOpenFactory instead')
+  @Deprecated('Override PowerSyncOpenFactory instead.')
   final SqliteConnectionSetup? _sqliteSetup;
 
   PowerSyncOpenFactory(
       {required super.path,
       super.sqliteOptions,
-      @Deprecated('Override PowerSyncOpenFactory instead')
+      @Deprecated('Override PowerSyncOpenFactory instead.')
       // ignore: deprecated_member_use_from_same_package
       SqliteConnectionSetup? sqliteSetup})
       // ignore: deprecated_member_use_from_same_package

packages/powersync/lib/src/powersync_database.dart

@@ -95,7 +95,7 @@ class PowerSyncDatabase with SqliteQueries implements SqliteConnection {
       required String path,
       int maxReaders = SqliteDatabase.defaultMaxReaders,
       Logger? logger,
-      @Deprecated("Use [PowerSyncDatabase.withFactory] instead")
+      @Deprecated("Use [PowerSyncDatabase.withFactory] instead.")
       // ignore: deprecated_member_use_from_same_package
       SqliteConnectionSetup? sqliteSetup}) {
     // ignore: deprecated_member_use_from_same_package

packages/powersync/pubspec.yaml

@@ -1,5 +1,5 @@
 name: powersync
-version: 1.2.1
+version: 1.2.2
 homepage: https://powersync.com
 repository: https://github.com/powersync-ja/powersync.dart
 description: PowerSync Flutter SDK - keep PostgreSQL databases in sync with on-device SQLite databases.

packages/powersync_attachments_helper/lib/src/syncing_service.dart

@@ -63,7 +63,7 @@ class SyncingService {
       await attachmentsService.deleteAttachment(attachment.id);
       return;
     } catch (e) {
-      log.severe('Download attachment error for attachment $attachment}', e);
+      log.severe('Download attachment error for attachment $attachment', e);
       return;
     }
   }