feat(synonyms): add deprecation logging and lsp info on old synonyms

Author: tharropoulos

src/main/java/org/typesense/api/Collection.java

@@ -66,11 +66,31 @@ public Document documents(String documentId) {
         return retVal;
     }
 
+    /**
+     * @deprecated This method is deprecated and will be removed in a future version.
+     * Use {@link Client#synonymSets()} instead for the new synonym sets API.
+     * 
+     * Note: The old synonyms API is only available on Typesense v29.0 and below.
+     * For Typesense v30.0 and above, use the new synonym sets API.
+     */
+    @Deprecated
     public Synonyms synonyms() {
+        System.err.println("DEPRECATED: Using deprecated synonyms API. This API is only available on Typesense v29.0 and below. " +
+                          "For Typesense v30.0 and above, use the new synonym sets API via Client.synonymSets().");
         return this.synonyms;
     }
 
+    /**
+     * @deprecated This method is deprecated and will be removed in a future version.
+     * Use {@link Client#synonymSet(String)} instead for the new synonym sets API.
+     * 
+     * Note: The old synonyms API is only available on Typesense v29.0 and below.
+     * For Typesense v30.0 and above, use the new synonym sets API.
+     */
+    @Deprecated
     public Synonym synonyms(String synonymId) {
+        System.err.println("DEPRECATED: Using deprecated synonyms API. This API is only available on Typesense v29.0 and below. " +
+                          "For Typesense v30.0 and above, use the new synonym sets API via Client.synonymSet(String).");
         Synonym retVal;
 
         if (!this.individualSynonyms.containsKey(synonymId)) {

src/main/java/org/typesense/api/Synonym.java

@@ -3,6 +3,15 @@
 import org.typesense.api.utils.URLEncoding;
 import org.typesense.model.SearchSynonym;
 
+/**
+ * @deprecated This class is deprecated and will be removed in a future version.
+ * Use {@link SynonymSet} instead for the new synonym sets API.
+ * 
+ * Note: The old synonyms API is only available on Typesense v29.0 and below.
+ * For Typesense v30.0 and above, use the new synonym sets API.
+ */
+@Deprecated
+
 public class Synonym {
 
     private String collectionName;

src/main/java/org/typesense/api/Synonyms.java

@@ -5,6 +5,15 @@
 import org.typesense.model.SearchSynonymSchema;
 import org.typesense.model.SearchSynonymsResponse;
 
+/**
+ * @deprecated This class is deprecated and will be removed in a future version.
+ * Use {@link SynonymSets} instead for the new synonym sets API.
+ * 
+ * Note: The old synonyms API is only available on Typesense v29.0 and below.
+ * For Typesense v30.0 and above, use the new synonym sets API.
+ */
+@Deprecated
+
 public class Synonyms {
 
     private String collectionName;