Core: Restrict visibility of spec-by-id API for scan planning responses (apache#14485)

Author: singhpk234

core/src/main/java/org/apache/iceberg/rest/responses/BaseScanTaskResponse.java

@@ -55,6 +55,10 @@ public List<DeleteFile> deleteFiles() {
     return deleteFiles;
   }
 
+  /**
+   * @deprecated since 1.11.0, visibility will be reduced in 1.12.0.
+   */
+  @Deprecated
   public Map<Integer, PartitionSpec> specsById() {
     return specsById;
   }
@@ -87,6 +91,10 @@ public B withDeleteFiles(List<DeleteFile> deleteFilesList) {
       return self();
     }
 
+    /**
+     * @deprecated since 1.11.0, visibility will be reduced in 1.12.0.
+     */
+    @Deprecated
     public B withSpecsById(Map<Integer, PartitionSpec> specs) {
       this.specsById = specs;
       return self();
@@ -104,6 +112,10 @@ public List<DeleteFile> deleteFiles() {
       return deleteFiles;
     }
 
+    /**
+     * @deprecated since 1.11.0, visibility will be reduced in 1.12.0.
+     */
+    @Deprecated
     public Map<Integer, PartitionSpec> specsById() {
       return specsById;
     }

core/src/main/java/org/apache/iceberg/rest/responses/FetchPlanningResultResponseParser.java

@@ -87,6 +87,7 @@ public static FetchPlanningResultResponse fromJson(
         .withPlanTasks(planTasks)
         .withFileScanTasks(fileScanTasks)
         .withDeleteFiles(deleteFiles)
+        .withSpecsById(specsById)
         .build();
   }
 }

core/src/main/java/org/apache/iceberg/rest/responses/FetchScanTasksResponseParser.java

@@ -77,6 +77,7 @@ public static FetchScanTasksResponse fromJson(
         TableScanResponseParser.parseFileScanTasks(json, deleteFiles, specsById, caseSensitive);
     return FetchScanTasksResponse.builder()
         .withPlanTasks(planTasks)
+        .withSpecsById(specsById)
         .withFileScanTasks(fileScanTasks)
         .withDeleteFiles(deleteFiles)
         .build();

core/src/main/java/org/apache/iceberg/rest/responses/PlanTableScanResponseParser.java

@@ -98,6 +98,7 @@ public static PlanTableScanResponse fromJson(
         .withPlanTasks(planTasks)
         .withFileScanTasks(fileScanTasks)
         .withDeleteFiles(deleteFiles)
+        .withSpecsById(specsById)
         .build();
   }
 }