minor version bump & mark old interfaces deprecated

Author: aastha25

coral-common/src/main/java/com/linkedin/coral/common/HiveDbSchema.java

@@ -39,7 +39,11 @@ public class HiveDbSchema implements Schema {
   private final String dbName;
 
   /**
-   * Constructor using CoralCatalog for unified table access.
+   * Constructor for HiveDbSchema. Exactly one of coralCatalog or msc must be non-null.
+   * 
+   * @param coralCatalog Coral catalog for unified access (can be null if msc is provided)
+   * @param msc Hive metastore client for Hive-specific access (can be null if coralCatalog is provided)
+   * @param dbName Database name (must not be null)
    */
   HiveDbSchema(CoralCatalog coralCatalog, HiveMetastoreClient msc, @Nonnull String dbName) {
     this.coralCatalog = coralCatalog;

coral-common/src/main/java/com/linkedin/coral/common/HiveMetastoreClient.java

@@ -15,7 +15,13 @@
  * Interface for accessing Hive Metastore.
  * Implementations of this interface handle connections to Hive metastore
  * and provide access to database and table metadata.
+ *
+ * @deprecated Use {@link com.linkedin.coral.common.catalog.CoralCatalog} instead.
+ *             CoralCatalog provides a unified interface supporting multiple table formats
+ *             (Hive, Iceberg, etc.) while this interface is Hive-specific.
+ *             Existing code using HiveMetastoreClient continues to work.
  */
+@Deprecated
 public interface HiveMetastoreClient {
 
   /**

coral-common/src/main/java/com/linkedin/coral/common/HiveMscAdapter.java

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017-2023 LinkedIn Corporation. All rights reserved.
+ * Copyright 2017-2025 LinkedIn Corporation. All rights reserved.
  * Licensed under the BSD-2 Clause license.
  * See LICENSE in the project root for license information.
  */
@@ -17,6 +17,15 @@
 import org.slf4j.LoggerFactory;
 
 
+/**
+ * Adapter implementation of {@link HiveMetastoreClient} that wraps
+ * Hadoop's {@link IMetaStoreClient}.
+ *
+ * @deprecated Use {@link com.linkedin.coral.common.catalog.CoralCatalog} instead.
+ *             This class is Hive-specific. For multi-format support (Hive, Iceberg),
+ *             implement CoralCatalog directly. Existing code continues to work.
+ */
+@Deprecated
 public class HiveMscAdapter implements HiveMetastoreClient {
 
   private final static Logger LOG = LoggerFactory.getLogger(HiveMscAdapter.class);

coral-common/src/main/java/com/linkedin/coral/common/ToRelConverter.java

@@ -52,7 +52,9 @@
  * This class should serve as the main entry point for clients to convert
  * SQL queries.
  * 
- * Uses CoralCatalog for unified access to different table formats.
+ * Supports both {@link com.linkedin.coral.common.catalog.CoralCatalog} (for unified
+ * multi-format access to Hive/Iceberg tables) and {@link HiveMetastoreClient}
+ * (for backward compatibility with Hive-only workflows).
  */
 public abstract class ToRelConverter {
 

version.properties

@@ -1,3 +1,3 @@
 # Version of the produced binaries.
 # The version is inferred by shipkit-auto-version Gradle plugin (https://github.com/shipkit/shipkit-auto-version)
-version=2.2.*
+version=2.3.*