@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.fluss.flink.tiering.committer;
+package org.apache.fluss.client.tiering;
 
 import org.apache.fluss.annotation.VisibleForTesting;
 import org.apache.fluss.client.metadata.MetadataUpdater;
@@ -229,7 +229,22 @@ public void commit(
         }
     }
 
-    void commit(
+    /**
+     * Registers a lake snapshot and its bucket offsets in Fluss.
+     *
+     * @param tableId the Fluss table ID
+     * @param snapshotId the lake snapshot ID
+     * @param lakeBucketTieredOffsetsPath the file containing tiered bucket offsets
+     * @param readableLakeBucketTieredOffsetsPath the file containing readable bucket offsets, or
+     *     {@code null} if the snapshot is not readable
+     * @param logEndOffsets the tiered log end offsets used for metrics reporting
+     * @param logMaxTieredTimestamps the maximum tiered timestamps used for metrics reporting
+     * @param earliestSnapshotIDToKeep the earliest snapshot ID to retain; {@code null} retains only
+     *     the latest snapshot, and {@link LakeCommitResult#KEEP_ALL_PREVIOUS} retains all previous
+     *     snapshots
+     * @throws IOException if the snapshot cannot be committed to Fluss
+     */
+    public void commit(
             long tableId,
             long snapshotId,
             String lakeBucketTieredOffsetsPath,
@@ -335,7 +350,7 @@ private CommitLakeTableSnapshotRequest toCommitLakeTableSnapshotRequest(
                 commitLakeTableSnapshotRequest.addLakeTableSnapshotMetadata();
         pbLakeTableSnapshotMetadata.setSnapshotId(snapshotId);
         pbLakeTableSnapshotMetadata.setTableId(tableId);
-        // tiered snapshot file path is equal to readable snapshot currently
+        // Keep the tiered offsets path separate from the optional readable offsets path.
         pbLakeTableSnapshotMetadata.setTieredBucketOffsetsFilePath(tieredBucketOffsetsPath);
         if (readableBucketTieredOffsetsPath != null) {
             pbLakeTableSnapshotMetadata.setReadableBucketOffsetsFilePath(
@@ -360,7 +375,7 @@ private CommitLakeTableSnapshotRequest toCommitLakeTableSnapshotRequest(
     }
 
     @VisibleForTesting
-    protected CommitLakeTableSnapshotRequest addLogEndOffsets(
+    CommitLakeTableSnapshotRequest addLogEndOffsets(
             CommitLakeTableSnapshotRequest commitLakeTableSnapshotRequest,
             long tableId,
             long snapshotId,
 
@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.fluss.flink.tiering.source;
+package org.apache.fluss.client.tiering;
 
 import org.apache.fluss.lake.writer.LakeWriter;
 import org.apache.fluss.metadata.TableBucket;
 
@@ -0,0 +1,52 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.fluss.client.tiering;
+
+import org.apache.fluss.lake.committer.TieringStats;
+
+import javax.annotation.Nullable;
+
+/**
+ * The result of one table's commit round, holding the lake committable (nullable for empty commits
+ * where no data was written) and the associated tiering statistics.
+ *
+ * @param <Committable> the type of the lake committable
+ */
+public class TieringCommitResult<Committable> {
+
+    /** The lake committable, or {@code null} if nothing was written in this round. */
+    @Nullable private final Committable committable;
+
+    /** Per-table tiering statistics collected during this round. */
+    @Nullable private final TieringStats stats;
+
+    public TieringCommitResult(@Nullable Committable committable, @Nullable TieringStats stats) {
+        this.committable = committable;
+        this.stats = stats;
+    }
+
+    @Nullable
+    public Committable getCommittable() {
+        return committable;
+    }
+
+    @Nullable
+    public TieringStats getStats() {
+        return stats;
+    }
+}