src/objective-c/GRPCClient/GRPCCallOptions.h - platform/external/grpc-grpc - Git at Google

 /*
  *
  * Copyright 2018 gRPC authors.
  *
  * 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.
  *
  */

 #import <Foundation/Foundation.h>

 NS_ASSUME_NONNULL_BEGIN

 /**
  * Safety remark of a gRPC method as defined in RFC 2616 Section 9.1
  */
 typedef NS_ENUM(NSUInteger, GRPCCallSafety) {
   /** Signal that there is no guarantees on how the call affects the server state. */
   GRPCCallSafetyDefault = 0,
   /** Signal that the call is idempotent. gRPC is free to use PUT verb. */
   GRPCCallSafetyIdempotentRequest = 1,
   /**
    * Signal that the call is cacheable and will not affect server state. gRPC is free to use GET
    * verb.
    */
   GRPCCallSafetyCacheableRequest = 2,
 };

 // Compression algorithm to be used by a gRPC call
 typedef NS_ENUM(NSUInteger, GRPCCompressionAlgorithm) {
   GRPCCompressNone = 0,
   GRPCCompressDeflate,
   GRPCCompressGzip,
   GRPCStreamCompressGzip,
 };

 // GRPCCompressAlgorithm is deprecated; use GRPCCompressionAlgorithm
 typedef GRPCCompressionAlgorithm GRPCCompressAlgorithm;

 /** The transport to be used by a gRPC call */
 typedef NS_ENUM(NSUInteger, GRPCTransportType) {
   GRPCTransportTypeDefault = 0,
   /** gRPC internal HTTP/2 stack with BoringSSL */
   GRPCTransportTypeChttp2BoringSSL = 0,
   /** Cronet stack */
   GRPCTransportTypeCronet,
   /** Insecure channel. FOR TEST ONLY! */
   GRPCTransportTypeInsecure,
 };

 /**
  * Implement this protocol to provide a token to gRPC when a call is initiated.
  */
 @protocol GRPCAuthorizationProtocol

 /**
  * This method is called when gRPC is about to start the call. When OAuth token is acquired,
  * \a handler is expected to be called with \a token being the new token to be used for this call.
  */
 - (void)getTokenWithHandler:(void (^)(NSString *_Nullable token))handler;

 @end

 @interface GRPCCallOptions : NSObject<NSCopying, NSMutableCopying>

 // Call parameters
 /**
  * The authority for the RPC. If nil, the default authority will be used.
  *
  * Note: This property does not have effect on Cronet transport and will be ignored.
  * Note: This property cannot be used to validate a self-signed server certificate. It control the
  *       :authority header field of the call and performs an extra check that server's certificate
  *       matches the :authority header.
  */
 @property(copy, readonly, nullable) NSString *serverAuthority;

 /**
  * The timeout for the RPC call in seconds. If set to 0, the call will not timeout. If set to
  * positive, the gRPC call returns with status GRPCErrorCodeDeadlineExceeded if it is not completed
  * within \a timeout seconds. A negative value is not allowed.
  */
 @property(readonly) NSTimeInterval timeout;

 /**
  * Enable flow control of a gRPC call. The option is default to NO. If set to YES, writeData: method
  * should only be called at most once before a didWriteData callback is issued, and
  * receiveNextMessage: must be called each time before gRPC call issues a didReceiveMessage
  * callback.
  */
 @property(readonly) BOOL enableFlowControl;

 // OAuth2 parameters. Users of gRPC may specify one of the following two parameters.

 /**
  * The OAuth2 access token string. The string is prefixed with "Bearer " then used as value of the
  * request's "authorization" header field. This parameter should not be used simultaneously with
  * \a authTokenProvider.
  */
 @property(copy, readonly, nullable) NSString *oauth2AccessToken;

 /**
  * The interface to get the OAuth2 access token string. gRPC will attempt to acquire token when
  * initiating the call. This parameter should not be used simultaneously with \a oauth2AccessToken.
  */
 @property(readonly, nullable) id<GRPCAuthorizationProtocol> authTokenProvider;

 /**
  * Initial metadata key-value pairs that should be included in the request.
  */
 @property(copy, readonly, nullable) NSDictionary *initialMetadata;

 // Channel parameters; take into account of channel signature.

 /**
  * Custom string that is prefixed to a request's user-agent header field before gRPC's internal
  * user-agent string.
  */
 @property(copy, readonly, nullable) NSString *userAgentPrefix;

 /**
  * The size limit for the response received from server. If it is exceeded, an error with status
  * code GRPCErrorCodeResourceExhausted is returned.
  */
 @property(readonly) NSUInteger responseSizeLimit;

 /**
  * The compression algorithm to be used by the gRPC call. For more details refer to
  * https://github.com/grpc/grpc/blob/master/doc/compression.md
  */
 @property(readonly) GRPCCompressionAlgorithm compressionAlgorithm;

 /**
  * Enable/Disable gRPC call's retry feature. The default is enabled. For details of this feature
  * refer to
  * https://github.com/grpc/proposal/blob/master/A6-client-retries.md
  */
 @property(readonly) BOOL retryEnabled;

 // HTTP/2 keep-alive feature. The parameter \a keepaliveInterval specifies the interval between two
 // PING frames. The parameter \a keepaliveTimeout specifies the length of the period for which the
 // call should wait for PING ACK. If PING ACK is not received after this period, the call fails.
 // Negative values are not allowed.
 @property(readonly) NSTimeInterval keepaliveInterval;
 @property(readonly) NSTimeInterval keepaliveTimeout;

 // Parameters for connection backoff. Negative values are not allowed.
 // For details of gRPC's backoff behavior, refer to
 // https://github.com/grpc/grpc/blob/master/doc/connection-backoff.md
 @property(readonly) NSTimeInterval connectMinTimeout;
 @property(readonly) NSTimeInterval connectInitialBackoff;
 @property(readonly) NSTimeInterval connectMaxBackoff;

 /**
  * Specify channel args to be used for this call. For a list of channel args available, see
  * grpc/grpc_types.h
  */
 @property(copy, readonly, nullable) NSDictionary *additionalChannelArgs;

 // Parameters for SSL authentication.

 /**
  * PEM format root certifications that is trusted. If set to nil, gRPC uses a list of default
  * root certificates.
  */
 @property(copy, readonly, nullable) NSString *PEMRootCertificates;

 /**
  * PEM format private key for client authentication, if required by the server.
  */
 @property(copy, readonly, nullable) NSString *PEMPrivateKey;

 /**
  * PEM format certificate chain for client authentication, if required by the server.
  */
 @property(copy, readonly, nullable) NSString *PEMCertificateChain;

 /**
  * Select the transport type to be used for this call.
  */
 @property(readonly) GRPCTransportType transportType;

 /**
  * Override the hostname during the TLS hostname validation process.
  */
 @property(copy, readonly, nullable) NSString *hostNameOverride;

 /**
  * A string that specify the domain where channel is being cached. Channels with different domains
  * will not get cached to the same connection.
  */
 @property(copy, readonly, nullable) NSString *channelPoolDomain;

 /**
  * Channel id allows control of channel caching within a channelPoolDomain. A call with a unique
  * channelID will create a new channel (connection) instead of reusing an existing one. Multiple
  * calls in the same channelPoolDomain using identical channelID are allowed to share connection
  * if other channel options are also the same.
  */
 @property(readonly) NSUInteger channelID;

 /**
  * Return if the channel options are equal to another object.
  */
 - (BOOL)hasChannelOptionsEqualTo:(GRPCCallOptions *)callOptions;

 /**
  * Hash for channel options.
  */
 @property(readonly) NSUInteger channelOptionsHash;

 @end

 @interface GRPCMutableCallOptions : GRPCCallOptions<NSCopying, NSMutableCopying>

 // Call parameters
 /**
  * The authority for the RPC. If nil, the default authority will be used.
  *
  * Note: This property does not have effect on Cronet transport and will be ignored.
  * Note: This property cannot be used to validate a self-signed server certificate. It control the
  *       :authority header field of the call and performs an extra check that server's certificate
  *       matches the :authority header.
  */
 @property(copy, readwrite, nullable) NSString *serverAuthority;

 /**
  * The timeout for the RPC call in seconds. If set to 0, the call will not timeout. If set to
  * positive, the gRPC call returns with status GRPCErrorCodeDeadlineExceeded if it is not completed
  * within \a timeout seconds. Negative value is invalid; setting the parameter to negative value
  * will reset the parameter to 0.
  */
 @property(readwrite) NSTimeInterval timeout;

 /**
  * Enable flow control of a gRPC call. The option is default to NO. If set to YES, writeData: method
  * should only be called at most once before a didWriteData callback is issued, and
  * receiveNextMessage: must be called each time before gRPC call can issue a didReceiveMessage
  * callback.
  *
  * If writeData: method is called more than once before issuance of a didWriteData callback, gRPC
  * will continue to queue the message and write them to gRPC core in order. However, the user
  * assumes their own responsibility of flow control by keeping tracking of the pending writes in
  * the call.
  */
 @property(readwrite) BOOL enableFlowControl;

 // OAuth2 parameters. Users of gRPC may specify one of the following two parameters.

 /**
  * The OAuth2 access token string. The string is prefixed with "Bearer " then used as value of the
  * request's "authorization" header field. This parameter should not be used simultaneously with
  * \a authTokenProvider.
  */
 @property(copy, readwrite, nullable) NSString *oauth2AccessToken;

 /**
  * The interface to get the OAuth2 access token string. gRPC will attempt to acquire token when
  * initiating the call. This parameter should not be used simultaneously with \a oauth2AccessToken.
  */
 @property(readwrite, nullable) id<GRPCAuthorizationProtocol> authTokenProvider;

 /**
  * Initial metadata key-value pairs that should be included in the request.
  */
 @property(copy, readwrite, nullable) NSDictionary *initialMetadata;

 // Channel parameters; take into account of channel signature.

 /**
  * Custom string that is prefixed to a request's user-agent header field before gRPC's internal
  * user-agent string.
  */
 @property(copy, readwrite, nullable) NSString *userAgentPrefix;

 /**
  * The size limit for the response received from server. If it is exceeded, an error with status
  * code GRPCErrorCodeResourceExhausted is returned.
  */
 @property(readwrite) NSUInteger responseSizeLimit;

 /**
  * The compression algorithm to be used by the gRPC call. For more details refer to
  * https://github.com/grpc/grpc/blob/master/doc/compression.md
  */
 @property(readwrite) GRPCCompressionAlgorithm compressionAlgorithm;

 /**
  * Enable/Disable gRPC call's retry feature. The default is enabled. For details of this feature
  * refer to
  * https://github.com/grpc/proposal/blob/master/A6-client-retries.md
  */
 @property(readwrite) BOOL retryEnabled;

 // HTTP/2 keep-alive feature. The parameter \a keepaliveInterval specifies the interval between two
 // PING frames. The parameter \a keepaliveTimeout specifies the length of the period for which the
 // call should wait for PING ACK. If PING ACK is not received after this period, the call fails.
 // Negative values are invalid; setting these parameters to negative value will reset the
 // corresponding parameter to 0.
 @property(readwrite) NSTimeInterval keepaliveInterval;
 @property(readwrite) NSTimeInterval keepaliveTimeout;

 // Parameters for connection backoff. Negative value is invalid; setting the parameters to negative
 // value will reset corresponding parameter to 0.
 // For details of gRPC's backoff behavior, refer to
 // https://github.com/grpc/grpc/blob/master/doc/connection-backoff.md
 @property(readwrite) NSTimeInterval connectMinTimeout;
 @property(readwrite) NSTimeInterval connectInitialBackoff;
 @property(readwrite) NSTimeInterval connectMaxBackoff;

 /**
  * Specify channel args to be used for this call. For a list of channel args available, see
  * grpc/grpc_types.h
  */
 @property(copy, readwrite, nullable) NSDictionary *additionalChannelArgs;

 // Parameters for SSL authentication.

 /**
  * PEM format root certifications that is trusted. If set to nil, gRPC uses a list of default
  * root certificates.
  */
 @property(copy, readwrite, nullable) NSString *PEMRootCertificates;

 /**
  * PEM format private key for client authentication, if required by the server.
  */
 @property(copy, readwrite, nullable) NSString *PEMPrivateKey;

 /**
  * PEM format certificate chain for client authentication, if required by the server.
  */
 @property(copy, readwrite, nullable) NSString *PEMCertificateChain;

 /**
  * Select the transport type to be used for this call.
  */
 @property(readwrite) GRPCTransportType transportType;

 /**
  * Override the hostname during the TLS hostname validation process.
  */
 @property(copy, readwrite, nullable) NSString *hostNameOverride;

 /**
  * A string that specify the domain where channel is being cached. Channels with different domains
  * will not get cached to the same channel. For example, a gRPC example app may use the channel pool
  * domain 'io.grpc.example' so that its calls do not reuse the channel created by other modules in
  * the same process.
  */
 @property(copy, readwrite, nullable) NSString *channelPoolDomain;

 /**
  * Channel id allows a call to force creating a new channel (connection) rather than using a cached
  * channel. Calls using distinct channelID's will not get cached to the same channel.
  */
 @property(readwrite) NSUInteger channelID;

 @end

 NS_ASSUME_NONNULL_END
	/*
	*
	* Copyright 2018 gRPC authors.
	*
	* 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.
	*
	*/

	#import <Foundation/Foundation.h>

	NS_ASSUME_NONNULL_BEGIN

	/**
	* Safety remark of a gRPC method as defined in RFC 2616 Section 9.1
	*/
	typedef NS_ENUM(NSUInteger, GRPCCallSafety) {
	/** Signal that there is no guarantees on how the call affects the server state. */
	GRPCCallSafetyDefault = 0,
	/** Signal that the call is idempotent. gRPC is free to use PUT verb. */
	GRPCCallSafetyIdempotentRequest = 1,
	/**
	* Signal that the call is cacheable and will not affect server state. gRPC is free to use GET
	* verb.
	*/
	GRPCCallSafetyCacheableRequest = 2,
	};

	// Compression algorithm to be used by a gRPC call
	typedef NS_ENUM(NSUInteger, GRPCCompressionAlgorithm) {
	GRPCCompressNone = 0,
	GRPCCompressDeflate,
	GRPCCompressGzip,
	GRPCStreamCompressGzip,
	};

	// GRPCCompressAlgorithm is deprecated; use GRPCCompressionAlgorithm
	typedef GRPCCompressionAlgorithm GRPCCompressAlgorithm;

	/** The transport to be used by a gRPC call */
	typedef NS_ENUM(NSUInteger, GRPCTransportType) {
	GRPCTransportTypeDefault = 0,
	/** gRPC internal HTTP/2 stack with BoringSSL */
	GRPCTransportTypeChttp2BoringSSL = 0,
	/** Cronet stack */
	GRPCTransportTypeCronet,
	/** Insecure channel. FOR TEST ONLY! */
	GRPCTransportTypeInsecure,
	};

	/**
	* Implement this protocol to provide a token to gRPC when a call is initiated.
	*/
	@protocol GRPCAuthorizationProtocol

	/**
	* This method is called when gRPC is about to start the call. When OAuth token is acquired,
	* \a handler is expected to be called with \a token being the new token to be used for this call.
	*/
	- (void)getTokenWithHandler:(void (^)(NSString *_Nullable token))handler;

	@end

	@interface GRPCCallOptions : NSObject<NSCopying, NSMutableCopying>

	// Call parameters
	/**
	* The authority for the RPC. If nil, the default authority will be used.
	*
	* Note: This property does not have effect on Cronet transport and will be ignored.
	* Note: This property cannot be used to validate a self-signed server certificate. It control the
	* :authority header field of the call and performs an extra check that server's certificate
	* matches the :authority header.
	*/
	@property(copy, readonly, nullable) NSString *serverAuthority;

	/**
	* The timeout for the RPC call in seconds. If set to 0, the call will not timeout. If set to
	* positive, the gRPC call returns with status GRPCErrorCodeDeadlineExceeded if it is not completed
	* within \a timeout seconds. A negative value is not allowed.
	*/
	@property(readonly) NSTimeInterval timeout;

	/**
	* Enable flow control of a gRPC call. The option is default to NO. If set to YES, writeData: method
	* should only be called at most once before a didWriteData callback is issued, and
	* receiveNextMessage: must be called each time before gRPC call issues a didReceiveMessage
	* callback.
	*/
	@property(readonly) BOOL enableFlowControl;

	// OAuth2 parameters. Users of gRPC may specify one of the following two parameters.

	/**
	* The OAuth2 access token string. The string is prefixed with "Bearer " then used as value of the
	* request's "authorization" header field. This parameter should not be used simultaneously with
	* \a authTokenProvider.
	*/
	@property(copy, readonly, nullable) NSString *oauth2AccessToken;

	/**
	* The interface to get the OAuth2 access token string. gRPC will attempt to acquire token when
	* initiating the call. This parameter should not be used simultaneously with \a oauth2AccessToken.
	*/
	@property(readonly, nullable) id<GRPCAuthorizationProtocol> authTokenProvider;

	/**
	* Initial metadata key-value pairs that should be included in the request.
	*/
	@property(copy, readonly, nullable) NSDictionary *initialMetadata;

	// Channel parameters; take into account of channel signature.

	/**
	* Custom string that is prefixed to a request's user-agent header field before gRPC's internal
	* user-agent string.
	*/
	@property(copy, readonly, nullable) NSString *userAgentPrefix;

	/**
	* The size limit for the response received from server. If it is exceeded, an error with status
	* code GRPCErrorCodeResourceExhausted is returned.
	*/
	@property(readonly) NSUInteger responseSizeLimit;

	/**
	* The compression algorithm to be used by the gRPC call. For more details refer to
	* https://github.com/grpc/grpc/blob/master/doc/compression.md
	*/
	@property(readonly) GRPCCompressionAlgorithm compressionAlgorithm;

	/**
	* Enable/Disable gRPC call's retry feature. The default is enabled. For details of this feature
	* refer to
	* https://github.com/grpc/proposal/blob/master/A6-client-retries.md
	*/
	@property(readonly) BOOL retryEnabled;

	// HTTP/2 keep-alive feature. The parameter \a keepaliveInterval specifies the interval between two
	// PING frames. The parameter \a keepaliveTimeout specifies the length of the period for which the
	// call should wait for PING ACK. If PING ACK is not received after this period, the call fails.
	// Negative values are not allowed.
	@property(readonly) NSTimeInterval keepaliveInterval;
	@property(readonly) NSTimeInterval keepaliveTimeout;

	// Parameters for connection backoff. Negative values are not allowed.
	// For details of gRPC's backoff behavior, refer to
	// https://github.com/grpc/grpc/blob/master/doc/connection-backoff.md
	@property(readonly) NSTimeInterval connectMinTimeout;
	@property(readonly) NSTimeInterval connectInitialBackoff;
	@property(readonly) NSTimeInterval connectMaxBackoff;

	/**
	* Specify channel args to be used for this call. For a list of channel args available, see
	* grpc/grpc_types.h
	*/
	@property(copy, readonly, nullable) NSDictionary *additionalChannelArgs;

	// Parameters for SSL authentication.

	/**
	* PEM format root certifications that is trusted. If set to nil, gRPC uses a list of default
	* root certificates.
	*/
	@property(copy, readonly, nullable) NSString *PEMRootCertificates;

	/**
	* PEM format private key for client authentication, if required by the server.
	*/
	@property(copy, readonly, nullable) NSString *PEMPrivateKey;

	/**
	* PEM format certificate chain for client authentication, if required by the server.
	*/
	@property(copy, readonly, nullable) NSString *PEMCertificateChain;

	/**
	* Select the transport type to be used for this call.
	*/
	@property(readonly) GRPCTransportType transportType;

	/**
	* Override the hostname during the TLS hostname validation process.
	*/
	@property(copy, readonly, nullable) NSString *hostNameOverride;

	/**
	* A string that specify the domain where channel is being cached. Channels with different domains
	* will not get cached to the same connection.
	*/
	@property(copy, readonly, nullable) NSString *channelPoolDomain;

	/**
	* Channel id allows control of channel caching within a channelPoolDomain. A call with a unique
	* channelID will create a new channel (connection) instead of reusing an existing one. Multiple
	* calls in the same channelPoolDomain using identical channelID are allowed to share connection
	* if other channel options are also the same.
	*/
	@property(readonly) NSUInteger channelID;

	/**
	* Return if the channel options are equal to another object.
	*/
	- (BOOL)hasChannelOptionsEqualTo:(GRPCCallOptions *)callOptions;

	/**
	* Hash for channel options.
	*/
	@property(readonly) NSUInteger channelOptionsHash;

	@end

	@interface GRPCMutableCallOptions : GRPCCallOptions<NSCopying, NSMutableCopying>

	// Call parameters
	/**
	* The authority for the RPC. If nil, the default authority will be used.
	*
	* Note: This property does not have effect on Cronet transport and will be ignored.
	* Note: This property cannot be used to validate a self-signed server certificate. It control the
	* :authority header field of the call and performs an extra check that server's certificate
	* matches the :authority header.
	*/
	@property(copy, readwrite, nullable) NSString *serverAuthority;

	/**
	* The timeout for the RPC call in seconds. If set to 0, the call will not timeout. If set to
	* positive, the gRPC call returns with status GRPCErrorCodeDeadlineExceeded if it is not completed
	* within \a timeout seconds. Negative value is invalid; setting the parameter to negative value
	* will reset the parameter to 0.
	*/
	@property(readwrite) NSTimeInterval timeout;

	/**
	* Enable flow control of a gRPC call. The option is default to NO. If set to YES, writeData: method
	* should only be called at most once before a didWriteData callback is issued, and
	* receiveNextMessage: must be called each time before gRPC call can issue a didReceiveMessage
	* callback.
	*
	* If writeData: method is called more than once before issuance of a didWriteData callback, gRPC
	* will continue to queue the message and write them to gRPC core in order. However, the user
	* assumes their own responsibility of flow control by keeping tracking of the pending writes in
	* the call.
	*/
	@property(readwrite) BOOL enableFlowControl;

	// OAuth2 parameters. Users of gRPC may specify one of the following two parameters.

	/**
	* The OAuth2 access token string. The string is prefixed with "Bearer " then used as value of the
	* request's "authorization" header field. This parameter should not be used simultaneously with
	* \a authTokenProvider.
	*/
	@property(copy, readwrite, nullable) NSString *oauth2AccessToken;

	/**
	* The interface to get the OAuth2 access token string. gRPC will attempt to acquire token when
	* initiating the call. This parameter should not be used simultaneously with \a oauth2AccessToken.
	*/
	@property(readwrite, nullable) id<GRPCAuthorizationProtocol> authTokenProvider;

	/**
	* Initial metadata key-value pairs that should be included in the request.
	*/
	@property(copy, readwrite, nullable) NSDictionary *initialMetadata;

	// Channel parameters; take into account of channel signature.

	/**
	* Custom string that is prefixed to a request's user-agent header field before gRPC's internal
	* user-agent string.
	*/
	@property(copy, readwrite, nullable) NSString *userAgentPrefix;

	/**
	* The size limit for the response received from server. If it is exceeded, an error with status
	* code GRPCErrorCodeResourceExhausted is returned.
	*/
	@property(readwrite) NSUInteger responseSizeLimit;

	/**
	* The compression algorithm to be used by the gRPC call. For more details refer to
	* https://github.com/grpc/grpc/blob/master/doc/compression.md
	*/
	@property(readwrite) GRPCCompressionAlgorithm compressionAlgorithm;

	/**
	* Enable/Disable gRPC call's retry feature. The default is enabled. For details of this feature
	* refer to
	* https://github.com/grpc/proposal/blob/master/A6-client-retries.md
	*/
	@property(readwrite) BOOL retryEnabled;

	// HTTP/2 keep-alive feature. The parameter \a keepaliveInterval specifies the interval between two
	// PING frames. The parameter \a keepaliveTimeout specifies the length of the period for which the
	// call should wait for PING ACK. If PING ACK is not received after this period, the call fails.
	// Negative values are invalid; setting these parameters to negative value will reset the
	// corresponding parameter to 0.
	@property(readwrite) NSTimeInterval keepaliveInterval;
	@property(readwrite) NSTimeInterval keepaliveTimeout;

	// Parameters for connection backoff. Negative value is invalid; setting the parameters to negative
	// value will reset corresponding parameter to 0.
	// For details of gRPC's backoff behavior, refer to
	// https://github.com/grpc/grpc/blob/master/doc/connection-backoff.md
	@property(readwrite) NSTimeInterval connectMinTimeout;
	@property(readwrite) NSTimeInterval connectInitialBackoff;
	@property(readwrite) NSTimeInterval connectMaxBackoff;

	/**
	* Specify channel args to be used for this call. For a list of channel args available, see
	* grpc/grpc_types.h
	*/
	@property(copy, readwrite, nullable) NSDictionary *additionalChannelArgs;

	// Parameters for SSL authentication.

	/**
	* PEM format root certifications that is trusted. If set to nil, gRPC uses a list of default
	* root certificates.
	*/
	@property(copy, readwrite, nullable) NSString *PEMRootCertificates;

	/**
	* PEM format private key for client authentication, if required by the server.
	*/
	@property(copy, readwrite, nullable) NSString *PEMPrivateKey;

	/**
	* PEM format certificate chain for client authentication, if required by the server.
	*/
	@property(copy, readwrite, nullable) NSString *PEMCertificateChain;

	/**
	* Select the transport type to be used for this call.
	*/
	@property(readwrite) GRPCTransportType transportType;

	/**
	* Override the hostname during the TLS hostname validation process.
	*/
	@property(copy, readwrite, nullable) NSString *hostNameOverride;

	/**
	* A string that specify the domain where channel is being cached. Channels with different domains
	* will not get cached to the same channel. For example, a gRPC example app may use the channel pool
	* domain 'io.grpc.example' so that its calls do not reuse the channel created by other modules in
	* the same process.
	*/
	@property(copy, readwrite, nullable) NSString *channelPoolDomain;

	/**
	* Channel id allows a call to force creating a new channel (connection) rather than using a cached
	* channel. Calls using distinct channelID's will not get cached to the same channel.
	*/
	@property(readwrite) NSUInteger channelID;

	@end

	NS_ASSUME_NONNULL_END