adding dev-v0.12.2 tag to this commit to ensure building

Author: rishabhpoddar

html/supertokens_python/constants.html

@@ -40,7 +40,7 @@ <h1 class="title">Module <code>supertokens_python.constants</code></h1>
 # License for the specific language governing permissions and limitations
 # under the License.
 SUPPORTED_CDI_VERSIONS = [&#34;2.9&#34;, &#34;2.10&#34;, &#34;2.11&#34;, &#34;2.12&#34;, &#34;2.13&#34;, &#34;2.14&#34;, &#34;2.15&#34;]
-VERSION = &#34;0.12.1&#34;
+VERSION = &#34;0.12.2&#34;
 TELEMETRY = &#34;/telemetry&#34;
 USER_COUNT = &#34;/users/count&#34;
 USER_DELETE = &#34;/user/remove&#34;

html/supertokens_python/framework/fastapi/fastapi_request.html

@@ -73,6 +73,8 @@ <h1 class="title">Module <code>supertokens_python.framework.fastapi.fastapi_requ
         return self.request.method
 
     def get_cookie(self, key: str) -&gt; Union[str, None]:
+        # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+        # It also takes care of escaping the quotes while fetching the value
         return self.request.cookies.get(key)
 
     def get_header(self, key: str) -&gt; Union[str, None]:
@@ -141,6 +143,8 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         return self.request.method
 
     def get_cookie(self, key: str) -&gt; Union[str, None]:
+        # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+        # It also takes care of escaping the quotes while fetching the value
         return self.request.cookies.get(key)
 
     def get_header(self, key: str) -&gt; Union[str, None]:
@@ -203,6 +207,8 @@ <h3>Methods</h3>
 <span>Expand source code</span>
 </summary>
 <pre><code class="python">def get_cookie(self, key: str) -&gt; Union[str, None]:
+    # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+    # It also takes care of escaping the quotes while fetching the value
     return self.request.cookies.get(key)</code></pre>
 </details>
 </dd>

html/supertokens_python/framework/fastapi/fastapi_response.html

@@ -41,10 +41,10 @@ <h1 class="title">Module <code>supertokens_python.framework.fastapi.fastapi_resp
 # under the License.
 import json
 from math import ceil
-from time import time
 from typing import Any, Dict, Optional
 
 from supertokens_python.framework.response import BaseResponse
+from supertokens_python.utils import get_timestamp_ms
 
 
 class FastApiResponse(BaseResponse):
@@ -77,31 +77,22 @@ <h1 class="title">Module <code>supertokens_python.framework.fastapi.fastapi_resp
         httponly: bool = False,
         samesite: str = &#34;lax&#34;,
     ):
-        if domain is None:
-            # we do ceil because if we do floor, we tests may fail where the access
-            # token lifetime is set to 1 second
-            self.response.set_cookie(
-                key=key,
-                value=value,
-                expires=ceil((expires - int(time() * 1000)) / 1000),
-                path=path,
-                secure=secure,
-                httponly=httponly,
-                samesite=samesite,
-            )
-        else:
-            # we do ceil because if we do floor, we tests may fail where the access
-            # token lifetime is set to 1 second
-            self.response.set_cookie(
-                key=key,
-                value=value,
-                expires=ceil((expires - int(time() * 1000)) / 1000),
-                path=path,
-                domain=domain,
-                secure=secure,
-                httponly=httponly,
-                samesite=samesite,
-            )
+        # Note: For FastAPI response object, the expires value
+        # doesn&#39;t mean the absolute time in ms, but the duration in seconds
+        # So we need to convert our absolute expiry time (ms) to a duration (seconds)
+
+        # we do ceil because if we do floor, we tests may fail where the access
+        # token lifetime is set to 1 second
+        self.response.set_cookie(
+            key=key,
+            value=value,  # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+            expires=ceil((expires - get_timestamp_ms()) / 1000),
+            path=path,
+            domain=domain,  # type: ignore # starlette didn&#39;t set domain as optional type but their default value is None anyways
+            secure=secure,
+            httponly=httponly,
+            samesite=samesite,
+        )
 
     def set_header(self, key: str, value: str):
         self.response.headers[key] = value
@@ -183,31 +174,22 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         httponly: bool = False,
         samesite: str = &#34;lax&#34;,
     ):
-        if domain is None:
-            # we do ceil because if we do floor, we tests may fail where the access
-            # token lifetime is set to 1 second
-            self.response.set_cookie(
-                key=key,
-                value=value,
-                expires=ceil((expires - int(time() * 1000)) / 1000),
-                path=path,
-                secure=secure,
-                httponly=httponly,
-                samesite=samesite,
-            )
-        else:
-            # we do ceil because if we do floor, we tests may fail where the access
-            # token lifetime is set to 1 second
-            self.response.set_cookie(
-                key=key,
-                value=value,
-                expires=ceil((expires - int(time() * 1000)) / 1000),
-                path=path,
-                domain=domain,
-                secure=secure,
-                httponly=httponly,
-                samesite=samesite,
-            )
+        # Note: For FastAPI response object, the expires value
+        # doesn&#39;t mean the absolute time in ms, but the duration in seconds
+        # So we need to convert our absolute expiry time (ms) to a duration (seconds)
+
+        # we do ceil because if we do floor, we tests may fail where the access
+        # token lifetime is set to 1 second
+        self.response.set_cookie(
+            key=key,
+            value=value,  # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+            expires=ceil((expires - get_timestamp_ms()) / 1000),
+            path=path,
+            domain=domain,  # type: ignore # starlette didn&#39;t set domain as optional type but their default value is None anyways
+            secure=secure,
+            httponly=httponly,
+            samesite=samesite,
+        )
 
     def set_header(self, key: str, value: str):
         self.response.headers[key] = value
@@ -298,31 +280,22 @@ <h3>Methods</h3>
     httponly: bool = False,
     samesite: str = &#34;lax&#34;,
 ):
-    if domain is None:
-        # we do ceil because if we do floor, we tests may fail where the access
-        # token lifetime is set to 1 second
-        self.response.set_cookie(
-            key=key,
-            value=value,
-            expires=ceil((expires - int(time() * 1000)) / 1000),
-            path=path,
-            secure=secure,
-            httponly=httponly,
-            samesite=samesite,
-        )
-    else:
-        # we do ceil because if we do floor, we tests may fail where the access
-        # token lifetime is set to 1 second
-        self.response.set_cookie(
-            key=key,
-            value=value,
-            expires=ceil((expires - int(time() * 1000)) / 1000),
-            path=path,
-            domain=domain,
-            secure=secure,
-            httponly=httponly,
-            samesite=samesite,
-        )</code></pre>
+    # Note: For FastAPI response object, the expires value
+    # doesn&#39;t mean the absolute time in ms, but the duration in seconds
+    # So we need to convert our absolute expiry time (ms) to a duration (seconds)
+
+    # we do ceil because if we do floor, we tests may fail where the access
+    # token lifetime is set to 1 second
+    self.response.set_cookie(
+        key=key,
+        value=value,  # Note: Unlike other frameworks, FastAPI wraps the value in quotes in Set-Cookie header
+        expires=ceil((expires - get_timestamp_ms()) / 1000),
+        path=path,
+        domain=domain,  # type: ignore # starlette didn&#39;t set domain as optional type but their default value is None anyways
+        secure=secure,
+        httponly=httponly,
+        samesite=samesite,
+    )</code></pre>
 </details>
 </dd>
 <dt id="supertokens_python.framework.fastapi.fastapi_response.FastApiResponse.set_header"><code class="name flex">