// Copyright 2026 Google LLC
//
// Licensed 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.

syntax = "proto3";

package google.spanner.v1;

import "google/api/field_behavior.proto";
import "google/protobuf/timestamp.proto";
import "google/spanner/v1/location.proto";
import "google/spanner/v1/transaction.proto";

option csharp_namespace = "Google.Cloud.Spanner.V1";
option go_package = "cloud.google.com/go/spanner/apiv1/spannerpb;spannerpb";
option java_multiple_files = true;
option java_outer_classname = "CommitResponseProto";
option java_package = "com.google.spanner.v1";
option php_namespace = "Google\\Cloud\\Spanner\\V1";
option ruby_package = "Google::Cloud::Spanner::V1";

// The response for [Commit][google.spanner.v1.Spanner.Commit].
message CommitResponse {
  // Additional statistics about a commit.
  message CommitStats {
    // The total number of mutations for the transaction. Knowing the
    // `mutation_count` value can help you maximize the number of mutations
    // in a transaction and minimize the number of API round trips. You can
    // also monitor this value to prevent transactions from exceeding the system
    // [limit](https://cloud.google.com/spanner/quotas#limits_for_creating_reading_updating_and_deleting_data).
    // If the number of mutations exceeds the limit, the server returns
    // [INVALID_ARGUMENT](https://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT).
    int64 mutation_count = 1;
  }

  // The Cloud Spanner timestamp at which the transaction committed.
  google.protobuf.Timestamp commit_timestamp = 1;

  // The statistics about this `Commit`. Not returned by default.
  // For more information, see
  // [CommitRequest.return_commit_stats][google.spanner.v1.CommitRequest.return_commit_stats].
  CommitStats commit_stats = 2;

  // You must examine and retry the commit if the following is populated.
  oneof MultiplexedSessionRetry {
    // If specified, transaction has not committed yet.
    // You must retry the commit with the new precommit token.
    MultiplexedSessionPrecommitToken precommit_token = 4;
  }

  // If `TransactionOptions.isolation_level` is set to
  // `IsolationLevel.REPEATABLE_READ`, then the snapshot timestamp is the
  // timestamp at which all reads in the transaction ran. This timestamp is
  // never returned.
  google.protobuf.Timestamp snapshot_timestamp = 5;

  // Optional. A cache update expresses a set of changes the client should
  // incorporate into its location cache. The client should discard the changes
  // if they are older than the data it already has. This data can be obtained
  // in response to requests that included a `RoutingHint` field, but may also
  // be obtained by explicit location-fetching RPCs which may be added in the
  // future.
  CacheUpdate cache_update = 6 [(google.api.field_behavior) = OPTIONAL];

  // The isolation level used for the read-write transaction.
  TransactionOptions.IsolationLevel isolation_level = 7;

  // The read lock mode used for the read-write transaction.
  TransactionOptions.ReadWrite.ReadLockMode read_lock_mode = 8;
}