feat: support contextual tuples in assertions

This does not add support to the OpenFGAClient, only the OpenFGAAPI

Author: ewanharris

docs/Assertion.md

@@ -6,6 +6,8 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **tuple_key** | [**AssertionTupleKey**](AssertionTupleKey.md) |  | 
 **expectation** | **bool** |  | 
+**contextual_tuples** | [**list[TupleKey]**](TupleKey.md) |  | [optional] 
+**context** | **object** | Additional request context that will be used to evaluate any ABAC conditions encountered in the query evaluation. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/OpenFgaApi.md

@@ -766,7 +766,7 @@ No authorization required
 
 Read assertions for an authorization model ID
 
-The ReadAssertions API will return, for a given authorization model id, all the assertions stored for it. An assertion is an object that contains a tuple key, and the expectation of whether a call to the Check API of that tuple key will return true or false. 
+The ReadAssertions API will return, for a given authorization model id, all the assertions stored for it. 
 
 ### Example
 
@@ -1187,7 +1187,7 @@ No authorization required
 
 Upsert assertions for an authorization model ID
 
-The WriteAssertions API will upsert new assertions for an authorization model id, or overwrite the existing ones. An assertion is an object that contains a tuple key, and the expectation of whether a call to the Check API of that tuple key will return true or false. 
+The WriteAssertions API will upsert new assertions for an authorization model id, or overwrite the existing ones. An assertion is an object that contains a tuple key, the expectation of whether a call to the Check API of that tuple key will return true or false, and optionally a list of contextual tuples.
 
 ### Example
 

openfga_sdk/models/assertion.py

@@ -33,22 +33,45 @@ class Assertion:
       attribute_map (dict): The key is attribute name
                             and the value is json key in definition.
     """
-    openapi_types = {"tuple_key": "AssertionTupleKey", "expectation": "bool"}
-
-    attribute_map = {"tuple_key": "tuple_key", "expectation": "expectation"}
-
-    def __init__(self, tuple_key=None, expectation=None, local_vars_configuration=None):
+    openapi_types = {
+        "tuple_key": "AssertionTupleKey",
+        "expectation": "bool",
+        "contextual_tuples": "list[TupleKey]",
+        "context": "object",
+    }
+
+    attribute_map = {
+        "tuple_key": "tuple_key",
+        "expectation": "expectation",
+        "contextual_tuples": "contextual_tuples",
+        "context": "context",
+    }
+
+    def __init__(
+        self,
+        tuple_key=None,
+        expectation=None,
+        contextual_tuples=None,
+        context=None,
+        local_vars_configuration=None,
+    ):
         """Assertion - a model defined in OpenAPI"""
         if local_vars_configuration is None:
             local_vars_configuration = Configuration.get_default_copy()
         self.local_vars_configuration = local_vars_configuration
 
         self._tuple_key = None
         self._expectation = None
+        self._contextual_tuples = None
+        self._context = None
         self.discriminator = None
 
         self.tuple_key = tuple_key
         self.expectation = expectation
+        if contextual_tuples is not None:
+            self.contextual_tuples = contextual_tuples
+        if context is not None:
+            self.context = context
 
     @property
     def tuple_key(self):
@@ -96,6 +119,58 @@ def expectation(self, expectation):
 
         self._expectation = expectation
 
+    @property
+    def contextual_tuples(self):
+        """Gets the contextual_tuples of this Assertion.
+
+
+        :return: The contextual_tuples of this Assertion.
+        :rtype: list[TupleKey]
+        """
+        return self._contextual_tuples
+
+    @contextual_tuples.setter
+    def contextual_tuples(self, contextual_tuples):
+        """Sets the contextual_tuples of this Assertion.
+
+
+        :param contextual_tuples: The contextual_tuples of this Assertion.
+        :type contextual_tuples: list[TupleKey]
+        """
+        if (
+            self.local_vars_configuration.client_side_validation
+            and contextual_tuples is not None
+            and len(contextual_tuples) > 20
+        ):
+            raise ValueError(
+                "Invalid value for `contextual_tuples`, number of items must be less than or equal to `20`"
+            )
+
+        self._contextual_tuples = contextual_tuples
+
+    @property
+    def context(self):
+        """Gets the context of this Assertion.
+
+        Additional request context that will be used to evaluate any ABAC conditions encountered in the query evaluation.
+
+        :return: The context of this Assertion.
+        :rtype: object
+        """
+        return self._context
+
+    @context.setter
+    def context(self, context):
+        """Sets the context of this Assertion.
+
+        Additional request context that will be used to evaluate any ABAC conditions encountered in the query evaluation.
+
+        :param context: The context of this Assertion.
+        :type context: object
+        """
+
+        self._context = context
+
     def to_dict(self, serialize=False):
         """Returns the model properties as a dict"""
         result = {}