qsafe-sdk 1.0.4

data/docs/CryptographicOperationsApi.md

@@ -0,0 +1,331 @@
+# QSafe::CryptographicOperationsApi
+
+All URIs are relative to *https://rushikesh66-pqc-api.hf.space*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**decrypt_data**](CryptographicOperationsApi.md#decrypt_data) | **POST** /keypairs/{keypairId}/decrypt | Decrypt data with a keypair's private key |
+| [**encrypt_data**](CryptographicOperationsApi.md#encrypt_data) | **POST** /keypairs/{keypairId}/encrypt | Encrypt data with a keypair's public key |
+| [**sign_data**](CryptographicOperationsApi.md#sign_data) | **POST** /keypairs/{keypairId}/sign | Sign data with a keypair's private key |
+| [**verify_signature**](CryptographicOperationsApi.md#verify_signature) | **POST** /keypairs/{keypairId}/verify | Verify a signature |
+
+
+## decrypt_data
+
+> <DecryptData200Response> decrypt_data(keypair_id, decrypt_request)
+
+Decrypt data with a keypair's private key
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure API key authorization: ApiKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure API key authorization: ApiKeyQuery
+  config.api_key['api_key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['api_key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::CryptographicOperationsApi.new
+keypair_id = '123e4567-e89b-12d3-a456-426614174000' # String | UUID v4 keypair identifier
+decrypt_request = QSafe::DecryptRequest.new # DecryptRequest | 
+
+begin
+  # Decrypt data with a keypair's private key
+  result = api_instance.decrypt_data(keypair_id, decrypt_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->decrypt_data: #{e}"
+end
+```
+
+#### Using the decrypt_data_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<DecryptData200Response>, Integer, Hash)> decrypt_data_with_http_info(keypair_id, decrypt_request)
+
+```ruby
+begin
+  # Decrypt data with a keypair's private key
+  data, status_code, headers = api_instance.decrypt_data_with_http_info(keypair_id, decrypt_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <DecryptData200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->decrypt_data_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **keypair_id** | **String** | UUID v4 keypair identifier |  |
+| **decrypt_request** | [**DecryptRequest**](DecryptRequest.md) |  |  |
+
+### Return type
+
+[**DecryptData200Response**](DecryptData200Response.md)
+
+### Authorization
+
+[ApiKeyHeader](../README.md#ApiKeyHeader), [ApiKeyQuery](../README.md#ApiKeyQuery), [BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## encrypt_data
+
+> <EncryptData200Response> encrypt_data(keypair_id, encrypt_request)
+
+Encrypt data with a keypair's public key
+
+Uses ML-KEM (Kyber). The keypair must use a `KYBER*` algorithm. Optionally stores result in ephemeral storage and returns an `ephemeral_id` for later decryption without passing raw ciphertext. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure API key authorization: ApiKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure API key authorization: ApiKeyQuery
+  config.api_key['api_key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['api_key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::CryptographicOperationsApi.new
+keypair_id = '123e4567-e89b-12d3-a456-426614174000' # String | UUID v4 keypair identifier
+encrypt_request = QSafe::EncryptRequest.new({plaintext: 'Hello, this is sensitive data to encrypt'}) # EncryptRequest | 
+
+begin
+  # Encrypt data with a keypair's public key
+  result = api_instance.encrypt_data(keypair_id, encrypt_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->encrypt_data: #{e}"
+end
+```
+
+#### Using the encrypt_data_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<EncryptData200Response>, Integer, Hash)> encrypt_data_with_http_info(keypair_id, encrypt_request)
+
+```ruby
+begin
+  # Encrypt data with a keypair's public key
+  data, status_code, headers = api_instance.encrypt_data_with_http_info(keypair_id, encrypt_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <EncryptData200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->encrypt_data_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **keypair_id** | **String** | UUID v4 keypair identifier |  |
+| **encrypt_request** | [**EncryptRequest**](EncryptRequest.md) |  |  |
+
+### Return type
+
+[**EncryptData200Response**](EncryptData200Response.md)
+
+### Authorization
+
+[ApiKeyHeader](../README.md#ApiKeyHeader), [ApiKeyQuery](../README.md#ApiKeyQuery), [BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## sign_data
+
+> <SignData200Response> sign_data(keypair_id, sign_request)
+
+Sign data with a keypair's private key
+
+Uses ML-DSA (Dilithium). The keypair must use a `DILITHIUM*` algorithm. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure API key authorization: ApiKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure API key authorization: ApiKeyQuery
+  config.api_key['api_key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['api_key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::CryptographicOperationsApi.new
+keypair_id = '123e4567-e89b-12d3-a456-426614174000' # String | UUID v4 keypair identifier
+sign_request = QSafe::SignRequest.new({message: 'I hereby approve this financial transaction of $10,000'}) # SignRequest | 
+
+begin
+  # Sign data with a keypair's private key
+  result = api_instance.sign_data(keypair_id, sign_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->sign_data: #{e}"
+end
+```
+
+#### Using the sign_data_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SignData200Response>, Integer, Hash)> sign_data_with_http_info(keypair_id, sign_request)
+
+```ruby
+begin
+  # Sign data with a keypair's private key
+  data, status_code, headers = api_instance.sign_data_with_http_info(keypair_id, sign_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SignData200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->sign_data_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **keypair_id** | **String** | UUID v4 keypair identifier |  |
+| **sign_request** | [**SignRequest**](SignRequest.md) |  |  |
+
+### Return type
+
+[**SignData200Response**](SignData200Response.md)
+
+### Authorization
+
+[ApiKeyHeader](../README.md#ApiKeyHeader), [ApiKeyQuery](../README.md#ApiKeyQuery), [BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## verify_signature
+
+> <VerifySignature200Response> verify_signature(keypair_id, verify_request)
+
+Verify a signature
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure API key authorization: ApiKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure API key authorization: ApiKeyQuery
+  config.api_key['api_key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['api_key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::CryptographicOperationsApi.new
+keypair_id = '123e4567-e89b-12d3-a456-426614174000' # String | UUID v4 keypair identifier
+verify_request = QSafe::VerifyRequest.new({message: 'I hereby approve this financial transaction of $10,000'}) # VerifyRequest | 
+
+begin
+  # Verify a signature
+  result = api_instance.verify_signature(keypair_id, verify_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->verify_signature: #{e}"
+end
+```
+
+#### Using the verify_signature_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<VerifySignature200Response>, Integer, Hash)> verify_signature_with_http_info(keypair_id, verify_request)
+
+```ruby
+begin
+  # Verify a signature
+  data, status_code, headers = api_instance.verify_signature_with_http_info(keypair_id, verify_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <VerifySignature200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling CryptographicOperationsApi->verify_signature_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **keypair_id** | **String** | UUID v4 keypair identifier |  |
+| **verify_request** | [**VerifyRequest**](VerifyRequest.md) |  |  |
+
+### Return type
+
+[**VerifySignature200Response**](VerifySignature200Response.md)
+
+### Authorization
+
+[ApiKeyHeader](../README.md#ApiKeyHeader), [ApiKeyQuery](../README.md#ApiKeyQuery), [BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/DebugApi.md

@@ -0,0 +1,84 @@
+# QSafe::DebugApi
+
+All URIs are relative to *https://rushikesh66-pqc-api.hf.space*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**debug_redis_test**](DebugApi.md#debug_redis_test) | **GET** /debug/redis-test | Test Redis and internal services |
+
+
+## debug_redis_test
+
+> <DebugRedisTest200Response> debug_redis_test
+
+Test Redis and internal services
+
+⚠️ Disable in production. Tests Redis connectivity and all enhanced services.
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure API key authorization: ApiKeyHeader
+  config.api_key['X-API-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-API-Key'] = 'Bearer'
+
+  # Configure API key authorization: ApiKeyQuery
+  config.api_key['api_key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['api_key'] = 'Bearer'
+
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::DebugApi.new
+
+begin
+  # Test Redis and internal services
+  result = api_instance.debug_redis_test
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling DebugApi->debug_redis_test: #{e}"
+end
+```
+
+#### Using the debug_redis_test_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<DebugRedisTest200Response>, Integer, Hash)> debug_redis_test_with_http_info
+
+```ruby
+begin
+  # Test Redis and internal services
+  data, status_code, headers = api_instance.debug_redis_test_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <DebugRedisTest200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling DebugApi->debug_redis_test_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**DebugRedisTest200Response**](DebugRedisTest200Response.md)
+
+### Authorization
+
+[ApiKeyHeader](../README.md#ApiKeyHeader), [ApiKeyQuery](../README.md#ApiKeyQuery), [BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/DebugRedisTest200Response.md

@@ -0,0 +1,30 @@
+# QSafe::DebugRedisTest200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **auth_type** | **String** |  | [optional] |
+| **database_size** | **Integer** |  | [optional] |
+| **keys_sample** | **Array<String>** |  | [optional] |
+| **ephemeral_stored** | **String** |  | [optional] |
+| **rate_limit_test** | [**DebugRedisTest200ResponseRateLimitTest**](DebugRedisTest200ResponseRateLimitTest.md) |  | [optional] |
+| **services_status** | [**DebugRedisTest200ResponseServicesStatus**](DebugRedisTest200ResponseServicesStatus.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DebugRedisTest200Response.new(
+  success: true,
+  auth_type: api_key,
+  database_size: 42,
+  keys_sample: ["user:123","session:456","rate_limit:789"],
+  ephemeral_stored: test-operation-id,
+  rate_limit_test: null,
+  services_status: null
+)
+```
+

data/docs/DebugRedisTest200ResponseRateLimitTest.md

@@ -0,0 +1,22 @@
+# QSafe::DebugRedisTest200ResponseRateLimitTest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **allowed** | **Boolean** |  | [optional] |
+| **remaining** | **Integer** |  | [optional] |
+| **reset_time** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DebugRedisTest200ResponseRateLimitTest.new(
+  allowed: null,
+  remaining: null,
+  reset_time: null
+)
+```
+

data/docs/DebugRedisTest200ResponseServicesStatus.md

@@ -0,0 +1,24 @@
+# QSafe::DebugRedisTest200ResponseServicesStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **api_key_middleware** | **String** |  | [optional] |
+| **usage_tracking** | **String** |  | [optional] |
+| **rate_limiting** | **String** |  | [optional] |
+| **security_monitoring** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DebugRedisTest200ResponseServicesStatus.new(
+  api_key_middleware: initialized,
+  usage_tracking: initialized,
+  rate_limiting: initialized,
+  security_monitoring: initialized
+)
+```
+

data/docs/DebugRedisTest500Response.md

@@ -0,0 +1,20 @@
+# QSafe::DebugRedisTest500Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error** | **String** |  | [optional] |
+| **stack** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DebugRedisTest500Response.new(
+  error: Redis connection failed,
+  stack: null
+)
+```
+

data/docs/DecryptData200Response.md

@@ -0,0 +1,20 @@
+# QSafe::DecryptData200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **data** | [**DecryptData200ResponseData**](DecryptData200ResponseData.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DecryptData200Response.new(
+  success: true,
+  data: null
+)
+```
+

data/docs/DecryptData200ResponseData.md

@@ -0,0 +1,24 @@
+# QSafe::DecryptData200ResponseData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **plaintext** | **String** | Decrypted plaintext | [optional] |
+| **algorithm** | **String** |  | [optional] |
+| **keypair_id** | **String** |  | [optional] |
+| **decompression_used** | **Boolean** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DecryptData200ResponseData.new(
+  plaintext: null,
+  algorithm: KYBER768,
+  keypair_id: null,
+  decompression_used: null
+)
+```
+

data/docs/DecryptRequest.md

@@ -0,0 +1,28 @@
+# QSafe::DecryptRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ephemeral_id** | **String** |  | [optional] |
+| **ephemeral_crypto** | [**DecryptRequestEphemeralCrypto**](DecryptRequestEphemeralCrypto.md) |  | [optional] |
+| **ciphertext** | **String** |  | [optional] |
+| **encapsulated_key** | **String** |  | [optional] |
+| **force_decrypt** | **Boolean** |  | [optional] |
+| **metadata** | **Hash<String, Object>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DecryptRequest.new(
+  ephemeral_id: eph_1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234,
+  ephemeral_crypto: null,
+  ciphertext: dGVzdCBjaXBoZXJ0ZXh0,
+  encapsulated_key: dGVzdCBlbmNhcHN1bGF0ZWQga2V5,
+  force_decrypt: false,
+  metadata: null
+)
+```
+

data/docs/DecryptRequestEphemeralCrypto.md

@@ -0,0 +1,24 @@
+# QSafe::DecryptRequestEphemeralCrypto
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ciphertext** | **String** |  |  |
+| **encapsulated_key** | **String** |  |  |
+| **integrity_hash** | **String** |  | [optional] |
+| **expires_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::DecryptRequestEphemeralCrypto.new(
+  ciphertext: dGVzdCBjaXBoZXJ0ZXh0,
+  encapsulated_key: dGVzdCBlbmNhcHN1bGF0ZWQga2V5,
+  integrity_hash: a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab,
+  expires_at: null
+)
+```
+

data/docs/EncryptData200Response.md

@@ -0,0 +1,20 @@
+# QSafe::EncryptData200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **data** | [**EncryptData200ResponseData**](EncryptData200ResponseData.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::EncryptData200Response.new(
+  success: true,
+  data: null
+)
+```
+

data/docs/EncryptData200ResponseData.md

@@ -0,0 +1,28 @@
+# QSafe::EncryptData200ResponseData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **operation_id** | **String** |  | [optional] |
+| **ciphertext** | **String** | Base64-encoded ciphertext | [optional] |
+| **encapsulated_key** | **String** | Base64-encoded KEM-encapsulated key | [optional] |
+| **algorithm** | **String** |  | [optional] |
+| **keypair_id** | **String** |  | [optional] |
+| **ephemeral_storage** | [**EncryptData200ResponseDataEphemeralStorage**](EncryptData200ResponseDataEphemeralStorage.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::EncryptData200ResponseData.new(
+  operation_id: null,
+  ciphertext: null,
+  encapsulated_key: null,
+  algorithm: KYBER768,
+  keypair_id: null,
+  ephemeral_storage: null
+)
+```
+

data/docs/EncryptData200ResponseDataEphemeralStorage.md

@@ -0,0 +1,22 @@
+# QSafe::EncryptData200ResponseDataEphemeralStorage
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ephemeral_id** | **String** | Use this ID in the decrypt request instead of raw ciphertext | [optional] |
+| **expires_in** | **Integer** | Seconds until the ephemeral data expires | [optional] |
+| **expires_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::EncryptData200ResponseDataEphemeralStorage.new(
+  ephemeral_id: null,
+  expires_in: null,
+  expires_at: null
+)
+```
+