From be766e48d05dd257d8743a0e666e2fc6480d58cd Mon Sep 17 00:00:00 2001
From: Paul Paterson <ptpaterson@gmail.com>
Date: Fri, 11 Oct 2024 15:43:43 -0400
Subject: [PATCH] Add deprecation decorations

---
 .../java/com/faunadb/common/Connection.java   |  6 ++++
 .../java/com/faunadb/client/FaunaClient.java  |  6 ++++
 .../src/main/scala/faunadb/FaunaClient.scala  | 34 ++++++++++++++++++-
 project/Settings.scala                        |  2 +-
 4 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/faunadb-common/src/main/java/com/faunadb/common/Connection.java b/faunadb-common/src/main/java/com/faunadb/common/Connection.java
index 28884619..01c09542 100644
--- a/faunadb-common/src/main/java/com/faunadb/common/Connection.java
+++ b/faunadb-common/src/main/java/com/faunadb/common/Connection.java
@@ -33,7 +33,13 @@
  *
  * <p>Relies on {@link java.net.http.HttpClient}
  * for the underlying implementation.</p>
+ *
+ * @deprecated
+ * Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10.
+ * Fauna accounts created after August 21, 2024 must use FQL v10.
+ * Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.
  */
+@Deprecated(since = "4.5.1")
 public class Connection {
 
   private static final String API_VERSION = "4";
diff --git a/faunadb-java/src/main/java/com/faunadb/client/FaunaClient.java b/faunadb-java/src/main/java/com/faunadb/client/FaunaClient.java
index ef157dc7..60ed5ed0 100644
--- a/faunadb-java/src/main/java/com/faunadb/client/FaunaClient.java
+++ b/faunadb-java/src/main/java/com/faunadb/client/FaunaClient.java
@@ -65,7 +65,13 @@
  * </pre>
  *
  * @see com.faunadb.client.query.Language
+ *
+ * @deprecated
+ * Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10.
+ * Fauna accounts created after August 21, 2024 must use FQL v10.
+ * Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.
  */
+@Deprecated(since = "4.5.1")
 public class FaunaClient {
 
   /**
diff --git a/faunadb-scala/src/main/scala/faunadb/FaunaClient.scala b/faunadb-scala/src/main/scala/faunadb/FaunaClient.scala
index a1c521f6..f76b05df 100644
--- a/faunadb-scala/src/main/scala/faunadb/FaunaClient.scala
+++ b/faunadb-scala/src/main/scala/faunadb/FaunaClient.scala
@@ -25,7 +25,19 @@ import scala.compat.java8.OptionConverters._
 import scala.concurrent.duration.FiniteDuration
 import scala.concurrent.{ExecutionContext, Future}
 
-/** Companion object to the FaunaClient class. */
+/**
+  * Companion object to the FaunaClient class.
+  *
+  * @deprecated
+  * Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10.
+  * Fauna accounts created after August 21, 2024 must use FQL v10.
+  * Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.
+  */
+@deprecated("Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10. " +
+  "Fauna accounts created after August 21, 2024 must use FQL v10. " +
+  "Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.",
+  "4.5.1"
+)
 object FaunaClient {
 
   // singleton ObjectMapper for all clients
@@ -43,7 +55,17 @@ object FaunaClient {
     *                     milliseconds precision. If not provided, a default timeout value is set on the server side.
     * @param userAgent A value used for the User-Agent HTTP header.
     * @return A configured FaunaClient instance.
+    *
+    * @deprecated
+    * Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10.
+    * Fauna accounts created after August 21, 2024 must use FQL v10.
+    * Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.
     */
+  @deprecated("Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10. " +
+    "Fauna accounts created after August 21, 2024 must use FQL v10. " +
+    "Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.",
+    "4.5.1"
+  )
   def apply(
     secret: String = null,
     endpoint: String = null,
@@ -105,7 +127,17 @@ object FaunaClient {
   * }}}
   *
   * @constructor create a new client with a configured [[com.faunadb.common.Connection]].
+  *
+  * @deprecated
+  * Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10.
+  * Fauna accounts created after August 21, 2024 must use FQL v10.
+  * Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.
   */
+@deprecated("Fauna is decommissioning FQL v4 on June 30, 2025. This driver is not compatible with FQL v10. " +
+  "Fauna accounts created after August 21, 2024 must use FQL v10. " +
+  "Ensure you migrate existing projects to the official v10 driver by the v4 EOL date: https://github.com/fauna/fauna-jvm.",
+  "4.5.1"
+)
 class FaunaClient private (connection: Connection) {
 
   /**
diff --git a/project/Settings.scala b/project/Settings.scala
index 11a949bf..13ccae86 100644
--- a/project/Settings.scala
+++ b/project/Settings.scala
@@ -6,7 +6,7 @@ import scoverage.ScoverageSbtPlugin.autoImport._
 
 object Settings {
 
-  lazy val driverVersion = "4.5.0"
+  lazy val driverVersion = "4.5.1"
 
   lazy val scala211 = "2.11.12"
   lazy val scala212 = "2.12.14"