Detect SyncEngine.isSynchronizing misuse in triggers

Package.swift

@@ -37,7 +37,8 @@ let package = Package(
     .package(url: "https://github.com/pointfreeco/swift-snapshot-testing", from: "1.18.4"),
     .package(
       url: "https://github.com/pointfreeco/swift-structured-queries",
-      from: "0.27.0",
+      branch: "main",
+      // from: "0.27.0",
       traits: [
         .trait(name: "StructuredQueriesTagged", condition: .when(traits: ["SQLiteDataTagged"]))
       ]

Sources/SQLiteData/CloudKit/SyncEngine.swift

@@ -899,7 +899,15 @@
     /// See <doc:CloudKit#Updating-triggers-to-be-compatible-with-synchronization> for more info.
     @DatabaseFunction("sqlitedata_icloud_syncEngineIsSynchronizingChanges")
     public static var isSynchronizing: Bool {
-      _isSynchronizingChanges
+      if _isCreatingTemporaryTrigger {
+        reportIssue(
+          """
+          Invoked 'SyncEngine.isSynchronizing' at trigger creation, which is unexpected. Use \
+          'SyncEngine.$isSynchronizing' to invoke at trigger execution, instead.
+          """
+        )
+      }
+      return _isSynchronizingChanges
     }
 
     @available(*, deprecated, message: "Use 'SyncEngine.$isSynchronizing', instead.")

Tests/SQLiteDataTests/AssertQueryTests.swift

@@ -136,7 +136,7 @@ struct AssertQueryTests {
         """
         SELECT "records"."id", "records"."date"
         FROM "records"
-        WHERE ("records"."id") = (1)
+        WHERE (("records"."id") = (1))
         """
       } results: {
         """

Tests/SQLiteDataTests/CloudKitTests/SyncEngineTests.swift

@@ -93,6 +93,28 @@
             """
         )
       }
+
+      @Test func isSynchronizingTriggerWarning() {
+        withKnownIssue {
+          _ = Reminder.createTemporaryTrigger(
+            after: .insert { new in
+              Values(SyncEngine.isSynchronizing)
+            }
+          )
+        } matching: { issue in
+          issue.description.hasSuffix(
+            """
+            Invoked 'SyncEngine.isSynchronizing' at trigger creation, which is unexpected. Use \
+            'SyncEngine.$isSynchronizing' to invoke at trigger execution, instead.
+            """
+          )
+        }
+        _ = Reminder.createTemporaryTrigger(
+          after: .insert { new in
+            Values(SyncEngine.$isSynchronizing)
+          }
+        )
+      }
     }
   }