updated from master

Author: stevensJourney

packages/powersync/CHANGELOG.md

@@ -1,6 +1,9 @@
 ## 1.3.0-alpha.1
 
 - Added initial support for Web platform.
+## 1.2.2
+
+- Deprecate DevConnector and related
 
 ## 1.2.1
 

packages/powersync/lib/src/connector.dart

@@ -8,9 +8,6 @@ import 'database/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;
@@ -64,7 +61,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);
@@ -150,6 +147,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;
@@ -198,6 +196,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/database/native/native_powersync_database.dart

@@ -73,7 +73,7 @@ class PowerSyncDatabaseImpl
       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/lib/src/database/powersync_database.dart

@@ -1,6 +1,7 @@
 import 'package:logging/logging.dart';
 import 'package:powersync/src/database/powersync_database_impl.dart';
 import 'package:powersync/src/database/powersync_db_mixin.dart';
+import 'package:powersync/src/open_factory/abstract_powersync_open_factory.dart';
 import 'package:sqlite_async/sqlite_async.dart';
 
 import '../schema.dart';
@@ -32,8 +33,14 @@ abstract class PowerSyncDatabase
   ///
   /// [logger] defaults to [autoLogger], which logs to the console in debug builds.
   factory PowerSyncDatabase(
-      {required Schema schema, required String path, Logger? logger}) {
-    return PowerSyncDatabaseImpl(schema: schema, path: path, logger: logger);
+      {required Schema schema,
+      required String path,
+      Logger? logger,
+      @Deprecated("Use [PowerSyncDatabase.withFactory] instead.")
+      // ignore: deprecated_member_use_from_same_package
+      SqliteConnectionSetup? sqliteSetup}) {
+    return PowerSyncDatabaseImpl(
+        schema: schema, path: path, logger: logger, sqliteSetup: sqliteSetup);
   }
 
   /// Open a [PowerSyncDatabase] with a [PowerSyncOpenFactory].

packages/powersync/lib/src/database/powersync_database_impl_stub.dart

@@ -48,7 +48,7 @@ class PowerSyncDatabaseImpl
       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}) {
     throw UnimplementedError();

packages/powersync/lib/src/database/web/web_powersync_database.dart

@@ -70,7 +70,7 @@ class PowerSyncDatabaseImpl
       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/lib/src/open_factory/abstract_powersync_open_factory.dart

@@ -68,7 +68,7 @@ abstract class AbstractPowerSyncOpenFactory extends DefaultSqliteOpenFactory {
 }
 
 /// Advanced: Define custom setup for each SQLite connection.
-@Deprecated('Use SqliteOpenFactory instead')
+@Deprecated('Use SqliteOpenFactory instead.')
 class SqliteConnectionSetup {
   final FutureOr<void> Function() _setup;
 

packages/powersync/lib/src/open_factory/native/native_open_factory.dart

@@ -9,13 +9,13 @@ import '../../uuid.dart';
 
 /// Native implementation for [AbstractPowerSyncOpenFactory]
 class PowerSyncOpenFactory extends AbstractPowerSyncOpenFactory {
-  @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.')
       SqliteConnectionSetup? sqliteSetup})
       // ignore: deprecated_member_use_from_same_package
       : _sqliteSetup = sqliteSetup;

packages/powersync/lib/src/open_factory/open_factory_stub.dart

@@ -5,7 +5,7 @@ class PowerSyncOpenFactory extends open_factory.AbstractPowerSyncOpenFactory {
   PowerSyncOpenFactory(
       {required super.path,
       super.sqliteOptions,
-      @Deprecated('Override PowerSyncOpenFactory instead')
+      @Deprecated('Override PowerSyncOpenFactory instead.')
       // ignore: deprecated_member_use_from_same_package
       open_factory.SqliteConnectionSetup? sqliteSetup});
 

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;
     }
   }