/*
 * Copyright 2024, gRPC Authors All rights reserved.
 *
 * 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.
 */

/// Additional information about an RPC handled by a server.
public struct ServerContext: Sendable {
  /// A description of the method being called.
  public var descriptor: MethodDescriptor

  /// A description of the remote peer.
  ///
  /// The format of the description should follow the pattern "<transport>:<address>" where
  /// "<transport>" indicates the underlying network transport (such as "ipv4", "unix", or
  /// "in-process"). This is a guideline for how descriptions should be formatted; different
  /// implementations may not follow this format so you shouldn't make assumptions based on it.
  ///
  /// Some examples include:
  /// - "ipv4:127.0.0.1:31415",
  /// - "ipv6:[::1]:443",
  /// - "in-process:27182".
  public var peer: String

  /// A handle for checking the cancellation status of an RPC.
  public var cancellation: RPCCancellationHandle

  /// Create a new server context.
  ///
  /// - Parameters:
  ///   - descriptor: A description of the method being called.
  ///   - peer: A description of the remote peer.
  ///   - cancellation: A cancellation handle. You can create a cancellation handle
  ///     using ``withServerContextRPCCancellationHandle(_:)``.
  public init(
    descriptor: MethodDescriptor,
    peer: String,
    cancellation: RPCCancellationHandle
  ) {
    self.descriptor = descriptor
    self.peer = peer
    self.cancellation = cancellation
  }
}