// Code generated by sidekick. DO NOT EDIT.
//
// 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
//
//     https://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.

#if UserLicenseService
  import Foundation
  #if canImport(FoundationNetworking)
    import FoundationNetworking
  #endif
  import GoogleCloudWkt
  import GoogleLongRunning
  import GoogleRpc
  import GoogleCloudGax

  /// Service for managing User Licenses.
  ///
  /// @Snippet(path: "UserLicenseServiceQuickstart")
  public class UserLicenseServiceClient: Clients.UserLicenseServiceProtocol {
    let inner: any Clients.UserLicenseServiceStub
    let pollingErrorPolicy: GoogleCloudGax.PollingErrorPolicy
    let pollingBackoffPolicy: GoogleCloudGax.BackoffPolicy

    /// Creates a new `UserLicenseServiceClient` instance.
    public init(_ options: GoogleCloudGax.ClientOptions = .init()) throws {
      var inner: any Clients.UserLicenseServiceStub = try Clients.UserLicenseServiceTransport(
        options)
      inner = Clients.UserLicenseServiceRetry(inner, options: options)
      if let logger = options.logger {
        inner = Clients.UserLicenseServiceLogging(inner, logger: logger)
      }
      self.inner = inner
      self.pollingErrorPolicy = options.pollingErrorPolicy
      self.pollingBackoffPolicy = options.pollingBackoffPolicy
    }

    /// Lists the User Licenses.
    ///
    /// @Snippet(path: "UserLicenseService_ListUserLicenses")
    public func listUserLicenses(
      request: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse {
      try await self.inner.listUserLicenses(request: request, options: options)
    }

    /// Lists the User Licenses.
    ///
    /// @Snippet(path: "UserLicenseService_ListUserLicenses")
    public func listUserLicenses(
      byItem: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) throws -> any AsyncSequence<UserLicense, Swift.Error> {
      let listRpc = {
        (token: Swift.String) async throws -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse
        in
        var request = byItem
        request.pageToken = token
        return try await self.listUserLicenses(request: request, options: options)
      }
      return GoogleCloudGax.PaginatedResponseSequence(listRpc: listRpc)
    }

    /// Updates the User License.
    /// This method is used for batch assign/unassign licenses to users.
    ///
    /// @Snippet(path: "UserLicenseService_BatchUpdateUserLicenses")
    public func batchUpdateUserLicenses(
      request: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.Operation {
      try await self.inner.batchUpdateUserLicenses(request: request, options: options)
    }

    /// Updates the User License.
    /// This method is used for batch assign/unassign licenses to users.
    ///
    /// @Snippet(path: "UserLicenseService_BatchUpdateUserLicenses")
    public func batchUpdateUserLicenses(
      withPolling: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> any GoogleCloudGax.PollableOperation<BatchUpdateUserLicensesResponse> {
      let extractStatus = {
        (op: GoogleLongRunning.Operation) throws
          -> GoogleCloudGax._PollableOperationImpl<BatchUpdateUserLicensesResponse>.State in
        guard op.done else {
          return .init(done: false, result: nil)
        }

        switch op.result {
        case .response(let anyValue):
          guard let anyValueUnwrapped = anyValue else {
            return .init(
              done: true,
              result: .failure(
                GoogleCloudGax.RequestError.binding(
                  "Operation completed but response value was missing")))
          }
          let response = try BatchUpdateUserLicensesResponse(fromAny: anyValueUnwrapped)
          return .init(done: true, result: .success(response))
        case .error(let status):
          guard let statusUnwrapped = status else {
            return .init(
              done: true,
              result: .failure(
                GoogleCloudGax.RequestError.binding(
                  "Operation completed but error value was missing")))
          }
          let error = GoogleCloudGax.RequestError.service(
            GoogleCloudGax.ServiceError(
              code: GoogleRpc.Code(intValue: Int(statusUnwrapped.code)),
              message: statusUnwrapped.message))
          return .init(done: true, result: .failure(error))
        case .none:
          return .init(
            done: true,
            result: .failure(
              GoogleCloudGax.RequestError.binding("Operation completed but result was missing")))
        }
      }
      let rawOp = try await self.batchUpdateUserLicenses(request: withPolling, options: options)
      let initialState = try extractStatus(rawOp)
      let poll = {
        () async throws
          -> GoogleCloudGax._PollableOperationImpl<BatchUpdateUserLicensesResponse>.State in
        let op = try await self.getOperation(
          request: .init().with { $0.name = rawOp.name }, options: options)
        return try extractStatus(op)
      }
      return GoogleCloudGax._PollableOperationImpl(
        initialState: initialState,
        polling: options.pollingErrorPolicy ?? self.pollingErrorPolicy,
        backoff: options.pollingBackoffPolicy ?? self.pollingBackoffPolicy,
        poll: poll,
      )
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: https://www.google.com/search?q=Swift+google.longrunning+Operations
    ///
    /// @Snippet(path: "UserLicenseService_ListOperations")
    public func listOperations(
      request: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.ListOperationsResponse {
      try await self.inner.listOperations(request: request, options: options)
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: https://www.google.com/search?q=Swift+google.longrunning+Operations
    ///
    /// @Snippet(path: "UserLicenseService_ListOperations")
    public func listOperations(
      byItem: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
    ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error> {
      let listRpc = {
        (token: Swift.String) async throws -> GoogleLongRunning.ListOperationsResponse in
        var request = byItem
        request.pageToken = token
        return try await self.listOperations(request: request, options: options)
      }
      return GoogleCloudGax.PaginatedResponseSequence(listRpc: listRpc)
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: https://www.google.com/search?q=Swift+google.longrunning+Operations
    ///
    /// @Snippet(path: "UserLicenseService_GetOperation")
    func getOperation(
      request: GoogleLongRunning.GetOperationRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.Operation {
      try await self.inner.getOperation(request: request, options: options)
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: https://www.google.com/search?q=Swift+google.longrunning+Operations
    ///
    /// @Snippet(path: "UserLicenseService_CancelOperation")
    public func cancelOperation(
      request: GoogleLongRunning.CancelOperationRequest, options: GoogleCloudGax.RequestOptions
    ) async throws {
      try await self.inner.cancelOperation(request: request, options: options)
    }
  }

  extension Clients {
    /// A Swift protocol to mock `UserLicenseServiceClient`.
    ///
    /// To mock `UserLicenseServiceClient` change your functions to receive
    /// `some UserLicenseServiceProtocol` or `any UserLicenseServiceProtocol`
    /// and pass a mock implementation in your tests.
    public protocol UserLicenseServiceProtocol {
      /// See `UserLicenseServiceClient.listUserLicenses`.
      func listUserLicenses(request: ListUserLicensesRequest) async throws
        -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse

      /// See `UserLicenseServiceClient.listUserLicenses`.
      func listUserLicenses(
        byItem: ListUserLicensesRequest
      ) throws -> any AsyncSequence<UserLicense, Swift.Error>

      /// See `UserLicenseServiceClient.listUserLicenses`.
      func listUserLicenses(
        parent: Swift.String,
      ) throws -> any AsyncSequence<UserLicense, Swift.Error>

      /// See `UserLicenseServiceClient.batchUpdateUserLicenses`.
      func batchUpdateUserLicenses(request: BatchUpdateUserLicensesRequest) async throws
        -> GoogleLongRunning.Operation

      /// See `UserLicenseServiceClient.batchUpdateUserLicenses`.
      func batchUpdateUserLicenses(withPolling: BatchUpdateUserLicensesRequest) async throws
        -> any GoogleCloudGax.PollableOperation<BatchUpdateUserLicensesResponse>

      /// See `UserLicenseServiceClient.listOperations`.
      func listOperations(request: GoogleLongRunning.ListOperationsRequest) async throws
        -> GoogleLongRunning.ListOperationsResponse

      /// See `UserLicenseServiceClient.listOperations`.
      func listOperations(
        byItem: GoogleLongRunning.ListOperationsRequest
      ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error>

      /// See `UserLicenseServiceClient.listOperations`.
      func listOperations(
        name: Swift.String,
        filter: Swift.String,
      ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error>

      /// See `UserLicenseServiceClient.cancelOperation`.
      func cancelOperation(request: GoogleLongRunning.CancelOperationRequest) async throws

      /// See `UserLicenseServiceClient.cancelOperation`.
      func cancelOperation(
        name: Swift.String,
      ) async throws

      /// See `UserLicenseServiceClient.listUserLicenses`.
      func listUserLicenses(
        request: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
      ) async throws -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse

      /// See `UserLicenseServiceClient.listUserLicenses`.
      func listUserLicenses(
        byItem: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
      ) throws -> any AsyncSequence<UserLicense, Swift.Error>

      /// See `UserLicenseServiceClient.batchUpdateUserLicenses`.
      func batchUpdateUserLicenses(
        request: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
      ) async throws -> GoogleLongRunning.Operation

      /// See `UserLicenseServiceClient.batchUpdateUserLicenses`.
      func batchUpdateUserLicenses(
        withPolling: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
      ) async throws -> any GoogleCloudGax.PollableOperation<BatchUpdateUserLicensesResponse>

      /// See `UserLicenseServiceClient.listOperations`.
      func listOperations(
        request: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
      ) async throws -> GoogleLongRunning.ListOperationsResponse

      /// See `UserLicenseServiceClient.listOperations`.
      func listOperations(
        byItem: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
      ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error>

      /// See `UserLicenseServiceClient.cancelOperation`.
      func cancelOperation(
        request: GoogleLongRunning.CancelOperationRequest, options: GoogleCloudGax.RequestOptions
      ) async throws
    }
  }

  // Default implementations
  extension Clients.UserLicenseServiceProtocol {
    public func listUserLicenses(request: ListUserLicensesRequest) async throws
      -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse
    {
      try await self.listUserLicenses(request: request, options: .init())
    }

    public func listUserLicenses(
      request: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse {
      throw GoogleCloudGax.RequestError.unimplemented
    }

    public func listUserLicenses(
      byItem: ListUserLicensesRequest
    ) throws -> any AsyncSequence<UserLicense, Swift.Error> {
      try self.listUserLicenses(byItem: byItem, options: .init())
    }

    public func listUserLicenses(
      byItem: ListUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) throws -> any AsyncSequence<UserLicense, Swift.Error> {
      let listRpc = {
        (token: Swift.String) async throws -> GoogleCloudDiscoveryEngineV1.ListUserLicensesResponse
        in
        throw GoogleCloudGax.RequestError.unimplemented
      }
      return GoogleCloudGax.PaginatedResponseSequence(listRpc: listRpc)
    }

    public func listUserLicenses(
      parent: Swift.String,
    ) throws -> any AsyncSequence<UserLicense, Swift.Error> {
      let request = ListUserLicensesRequest().with {
        $0.parent = parent
      }
      return try self.listUserLicenses(byItem: request)
    }

    public func batchUpdateUserLicenses(request: BatchUpdateUserLicensesRequest) async throws
      -> GoogleLongRunning.Operation
    {
      try await self.batchUpdateUserLicenses(request: request, options: .init())
    }

    public func batchUpdateUserLicenses(
      request: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.Operation {
      throw GoogleCloudGax.RequestError.unimplemented
    }

    public func batchUpdateUserLicenses(withPolling: BatchUpdateUserLicensesRequest) async throws
      -> any GoogleCloudGax.PollableOperation<BatchUpdateUserLicensesResponse>
    {
      try await self.batchUpdateUserLicenses(withPolling: withPolling, options: .init())
    }

    public func batchUpdateUserLicenses(
      withPolling: BatchUpdateUserLicensesRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> any GoogleCloudGax.PollableOperation<BatchUpdateUserLicensesResponse> {
      let poll = {
        () async throws
          -> GoogleCloudGax._PollableOperationImpl<BatchUpdateUserLicensesResponse>.State in
        throw GoogleCloudGax.RequestError.unimplemented
      }
      return GoogleCloudGax._PollableOperationImpl(
        initialState: .init(done: false, result: nil), poll: poll)
    }

    public func listOperations(request: GoogleLongRunning.ListOperationsRequest) async throws
      -> GoogleLongRunning.ListOperationsResponse
    {
      try await self.listOperations(request: request, options: .init())
    }

    public func listOperations(
      request: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.ListOperationsResponse {
      throw GoogleCloudGax.RequestError.unimplemented
    }

    public func listOperations(
      byItem: GoogleLongRunning.ListOperationsRequest
    ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error> {
      try self.listOperations(byItem: byItem, options: .init())
    }

    public func listOperations(
      byItem: GoogleLongRunning.ListOperationsRequest, options: GoogleCloudGax.RequestOptions
    ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error> {
      let listRpc = {
        (token: Swift.String) async throws -> GoogleLongRunning.ListOperationsResponse in
        throw GoogleCloudGax.RequestError.unimplemented
      }
      return GoogleCloudGax.PaginatedResponseSequence(listRpc: listRpc)
    }

    public func listOperations(
      name: Swift.String,
      filter: Swift.String,
    ) throws -> any AsyncSequence<GoogleLongRunning.Operation, Swift.Error> {
      let request = GoogleLongRunning.ListOperationsRequest().with {
        $0.name = name
        $0.filter = filter
      }
      return try self.listOperations(byItem: request)
    }

    public func getOperation(request: GoogleLongRunning.GetOperationRequest) async throws
      -> GoogleLongRunning.Operation
    {
      try await self.getOperation(request: request, options: .init())
    }

    public func getOperation(
      request: GoogleLongRunning.GetOperationRequest, options: GoogleCloudGax.RequestOptions
    ) async throws -> GoogleLongRunning.Operation {
      throw GoogleCloudGax.RequestError.unimplemented
    }

    public func getOperation(
      name: Swift.String,
    ) async throws -> GoogleLongRunning.Operation {
      let request = GoogleLongRunning.GetOperationRequest().with {
        $0.name = name
      }
      return try await self.getOperation(request: request)
    }

    public func cancelOperation(request: GoogleLongRunning.CancelOperationRequest) async throws {
      try await self.cancelOperation(request: request, options: .init())
    }

    public func cancelOperation(
      request: GoogleLongRunning.CancelOperationRequest, options: GoogleCloudGax.RequestOptions
    ) async throws {
      throw GoogleCloudGax.RequestError.unimplemented
    }

    public func cancelOperation(
      name: Swift.String,
    ) async throws {
      let request = GoogleLongRunning.CancelOperationRequest().with {
        $0.name = name
      }
      try await self.cancelOperation(request: request)
    }
  }
#endif
