appwrite 24.0.0rc1__tar.gz → 24.2.0__tar.gz

{appwrite-24.0.0rc1 → appwrite-24.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: appwrite
-Version: 24.0.0rc1
+Version: 24.2.0
 Summary: Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API
 Home-page: https://appwrite.io/support
-Download-URL: https://github.com/appwrite/sdk-for-python/archive/24.0.0rc1.tar.gz
+Download-URL: https://github.com/appwrite/sdk-for-python/archive/24.2.0.tar.gz
 Author: Appwrite Team
 Author-email: Appwrite Team <team@appwrite.io>
 Maintainer: Appwrite Team
@@ -39,12 +39,12 @@ Dynamic: requires-python
 # Appwrite Python SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-python.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.9.6-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-2.0.0-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version 1.9.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-python/releases).**
+**This SDK targets Appwrite server version 1.9.x as shipped on Appwrite Cloud.** Self-hosted releases can lag behind Cloud — if you run an older self-hosted build, use a matching older SDK from [previous releases](https://github.com/appwrite/sdk-for-python/releases) when APIs differ.
 
 Appwrite is an open-source backend as a service server that abstracts and simplifies complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Python SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 

{appwrite-24.0.0rc1 → appwrite-24.2.0}/README.md

@@ -1,12 +1,12 @@
 # Appwrite Python SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-python.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.9.6-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-2.0.0-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version 1.9.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-python/releases).**
+**This SDK targets Appwrite server version 1.9.x as shipped on Appwrite Cloud.** Self-hosted releases can lag behind Cloud — if you run an older self-hosted build, use a matching older SDK from [previous releases](https://github.com/appwrite/sdk-for-python/releases) when APIs differ.
 
 Appwrite is an open-source backend as a service server that abstracts and simplifies complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Python SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/client.py

@@ -18,12 +18,12 @@ class Client:
         self._endpoint = 'https://cloud.appwrite.io/v1'
         self._global_headers = {
             'content-type': '',
-            'user-agent': f'AppwritePythonSDK/24.0.0rc1 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
+            'user-agent': f'AppwritePythonSDK/24.2.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
             'x-sdk-name': 'Python',
             'x-sdk-platform': 'server',
             'x-sdk-language': 'python',
-            'x-sdk-version': '24.0.0rc1',
-            'X-Appwrite-Response-Format': '1.9.6',
+            'x-sdk-version': '24.2.0',
+            'X-Appwrite-Response-Format': '2.0.0',
         }
         self._config = {}
 

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/enums/o_auth_provider.py

@@ -11,6 +11,7 @@ class OAuthProvider(Enum):
     BITBUCKET = "bitbucket"
     BITLY = "bitly"
     BOX = "box"
+    CLOUDFLARE = "cloudflare"
     DAILYMOTION = "dailymotion"
     DISCORD = "discord"
     DISQUS = "disqus"
@@ -33,6 +34,7 @@ class OAuthProvider(Enum):
     PAYPAL = "paypal"
     PAYPALSANDBOX = "paypalSandbox"
     PODIO = "podio"
+    RESEND = "resend"
     SALESFORCE = "salesforce"
     SLACK = "slack"
     SPOTIFY = "spotify"

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/enums/project_key_scopes.py

@@ -50,12 +50,16 @@ class ProjectKeyScopes(Enum):
     DOCUMENTSDB_COLLECTIONS_WRITE = "documentsdb.collections.write"
     DOCUMENTSDB_DOCUMENTS_READ = "documentsdb.documents.read"
     DOCUMENTSDB_DOCUMENTS_WRITE = "documentsdb.documents.write"
+    DOCUMENTSDB_INDEXES_READ = "documentsdb.indexes.read"
+    DOCUMENTSDB_INDEXES_WRITE = "documentsdb.indexes.write"
     VECTORSDB_READ = "vectorsdb.read"
     VECTORSDB_WRITE = "vectorsdb.write"
     VECTORSDB_COLLECTIONS_READ = "vectorsdb.collections.read"
     VECTORSDB_COLLECTIONS_WRITE = "vectorsdb.collections.write"
     VECTORSDB_DOCUMENTS_READ = "vectorsdb.documents.read"
     VECTORSDB_DOCUMENTS_WRITE = "vectorsdb.documents.write"
+    VECTORSDB_INDEXES_READ = "vectorsdb.indexes.read"
+    VECTORSDB_INDEXES_WRITE = "vectorsdb.indexes.write"
     BUCKETS_READ = "buckets.read"
     BUCKETS_WRITE = "buckets.write"
     FILES_READ = "files.read"

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/enums/project_o_auth_provider_id.py

@@ -11,6 +11,7 @@ class ProjectOAuthProviderId(Enum):
     BITBUCKET = "bitbucket"
     BITLY = "bitly"
     BOX = "box"
+    CLOUDFLARE = "cloudflare"
     DAILYMOTION = "dailymotion"
     DISCORD = "discord"
     DISQUS = "disqus"
@@ -33,6 +34,7 @@ class ProjectOAuthProviderId(Enum):
     PAYPAL = "paypal"
     PAYPALSANDBOX = "paypalSandbox"
     PODIO = "podio"
+    RESEND = "resend"
     SALESFORCE = "salesforce"
     SLACK = "slack"
     SPOTIFY = "spotify"

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/__init__.py

@@ -157,6 +157,7 @@ from .o_auth2_podio import OAuth2Podio
 from .o_auth2_notion import OAuth2Notion
 from .o_auth2_salesforce import OAuth2Salesforce
 from .o_auth2_yahoo import OAuth2Yahoo
+from .o_auth2_cloudflare import OAuth2Cloudflare
 from .o_auth2_hugging_face import OAuth2HuggingFace
 from .o_auth2_linkedin import OAuth2Linkedin
 from .o_auth2_disqus import OAuth2Disqus
@@ -176,6 +177,7 @@ from .o_auth2_okta import OAuth2Okta
 from .o_auth2_kick import OAuth2Kick
 from .o_auth2_apple import OAuth2Apple
 from .o_auth2_microsoft import OAuth2Microsoft
+from .o_auth2_resend import OAuth2Resend
 from .o_auth2_provider_list import OAuth2ProviderList
 from .policy_password_dictionary import PolicyPasswordDictionary
 from .policy_password_history import PolicyPasswordHistory
@@ -458,6 +460,7 @@ __all__ = [
     'OAuth2Notion',
     'OAuth2Salesforce',
     'OAuth2Yahoo',
+    'OAuth2Cloudflare',
     'OAuth2HuggingFace',
     'OAuth2Linkedin',
     'OAuth2Disqus',
@@ -477,6 +480,7 @@ __all__ = [
     'OAuth2Kick',
     'OAuth2Apple',
     'OAuth2Microsoft',
+    'OAuth2Resend',
     'OAuth2ProviderList',
     'PolicyPasswordDictionary',
     'PolicyPasswordHistory',

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/billing_plan.py

@@ -91,6 +91,8 @@ class BillingPlan(AppwriteModel):
         Usage history days
     usagelogsintervals : Optional[List[Any]]
         Usage log time intervals allowed for this plan (e.g. 15m, 1h, 1d).
+    usageaggregateonlymetrics : Optional[List[Any]]
+        Metrics this plan only records as a total. They cannot be broken down by dimension or filtered, because the stored events cover a fraction of the real traffic.
     projectinactivitydays : float
         Number of days of console inactivity before a project is paused. 0 means pausing is disabled.
     alertlimit : float
@@ -147,6 +149,8 @@ class BillingPlan(AppwriteModel):
         Maximum function and site deployment size in MB
     buildsize : float
         Maximum function and site deployment size in MB
+    functionsintervalminimum : float
+        Shortest function schedule interval allowed, in minutes. 0 allows every interval.
     databasesallowencrypt : bool
         Does the plan support encrypted string attributes or not.
     limits : Optional[BillingPlanLimits]
@@ -198,6 +202,7 @@ class BillingPlan(AppwriteModel):
     activitylogs: Optional[float] = Field(default=None, alias='activityLogs')
     usagelogs: float = Field(..., alias='usageLogs')
     usagelogsintervals: Optional[List[Any]] = Field(default=None, alias='usageLogsIntervals')
+    usageaggregateonlymetrics: Optional[List[Any]] = Field(default=None, alias='usageAggregateOnlyMetrics')
     projectinactivitydays: float = Field(..., alias='projectInactivityDays')
     alertlimit: float = Field(..., alias='alertLimit')
     usage: UsageBillingPlan = Field(..., alias='usage')
@@ -226,6 +231,7 @@ class BillingPlan(AppwriteModel):
     backuppolicies: Optional[float] = Field(default=None, alias='backupPolicies')
     deploymentsize: float = Field(..., alias='deploymentSize')
     buildsize: float = Field(..., alias='buildSize')
+    functionsintervalminimum: float = Field(..., alias='functionsIntervalMinimum')
     databasesallowencrypt: bool = Field(..., alias='databasesAllowEncrypt')
     limits: Optional[BillingPlanLimits] = Field(default=None, alias='limits')
     group: BillingPlanGroup = Field(..., alias='group')

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/dedicated_database.py

@@ -29,7 +29,7 @@ class DedicatedDatabase(AppwriteModel):
     specification : str
         Specification identifier.
     backend : str
-        Database backend provider. Possible values: prisma, edge.
+        Database backend provider. Possible values: edge.
     hostname : str
         Database hostname for connections.
     connectionport : float
@@ -38,6 +38,8 @@ class DedicatedDatabase(AppwriteModel):
         Database username for connections.
     connectionpassword : str
         Database password for connections.
+    credentialgeneration : float
+        Committed generation of the primary connection credentials. Null until the rotation contract has been initialized.
     connectionstring : str
         Full database connection string (URI format).
     ssl : bool
@@ -122,6 +124,7 @@ class DedicatedDatabase(AppwriteModel):
     connectionport: float = Field(..., alias='connectionPort')
     connectionuser: str = Field(..., alias='connectionUser')
     connectionpassword: str = Field(..., alias='connectionPassword')
+    credentialgeneration: float = Field(..., alias='credentialGeneration')
     connectionstring: str = Field(..., alias='connectionString')
     ssl: bool = Field(..., alias='ssl')
     status: str = Field(..., alias='status')

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/dedicated_database_operation.py

@@ -17,7 +17,7 @@ class DedicatedDatabaseOperation(AppwriteModel):
     databaseid : str
         Database ID the operation ran against.
     type : str
-        Operation type, such as provision, update, restore, pausing, resuming, failover, backup-create or cross-region-enable.
+        Operation type, such as provision, update, credentials-update, restore, pausing, resuming, failover, backup-create or cross-region-enable.
     status : str
         Operation status. Possible values: queued (accepted and waiting to resume), running (in progress), completed (finished successfully), failed (ended in an error).
     attempts : float

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/framework_adapter.py

@@ -18,7 +18,7 @@ class FrameworkAdapter(AppwriteModel):
         Default command to build site into output directory.
     outputdirectory : str
         Default output directory of build.
-    fallbackfile : str
+    fallbackfile : Optional[str]
         Name of fallback file to use instead of 404 page. If null, Appwrite 404 page will be displayed.
     """
 
@@ -26,4 +26,4 @@ class FrameworkAdapter(AppwriteModel):
     installcommand: str = Field(..., alias='installCommand')
     buildcommand: str = Field(..., alias='buildCommand')
     outputdirectory: str = Field(..., alias='outputDirectory')
-    fallbackfile: str = Field(..., alias='fallbackFile')
+    fallbackfile: Optional[str] = Field(default=None, alias='fallbackFile')

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/function.py

@@ -49,6 +49,8 @@ class Function(AppwriteModel):
         Function trigger events.
     schedule : str
         Function execution schedule in CRON format.
+    interval : Optional[float]
+        Minutes between scheduled executions. 0 when the function has no interval.
     timeout : float
         Function execution timeout in seconds.
     entrypoint : str
@@ -96,6 +98,7 @@ class Function(AppwriteModel):
     vars: List[Variable] = Field(..., alias='vars')
     events: List[Any] = Field(..., alias='events')
     schedule: str = Field(..., alias='schedule')
+    interval: Optional[float] = Field(default=None, alias='interval')
     timeout: float = Field(..., alias='timeout')
     entrypoint: str = Field(..., alias='entrypoint')
     commands: str = Field(..., alias='commands')

appwrite-24.2.0/appwrite/models/o_auth2_cloudflare.py

@@ -0,0 +1,26 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+
+
+class OAuth2Cloudflare(AppwriteModel):
+    """
+    OAuth2Cloudflare
+
+    Attributes
+    ----------
+    id : str
+        OAuth2 provider ID.
+    enabled : bool
+        OAuth2 provider is active and can be used to create sessions.
+    clientid : str
+        Cloudflare OAuth2 client ID.
+    clientsecret : str
+        Cloudflare OAuth2 client secret.
+    """
+
+    id: str = Field(..., alias='$id')
+    enabled: bool = Field(..., alias='enabled')
+    clientid: str = Field(..., alias='clientId')
+    clientsecret: str = Field(..., alias='clientSecret')

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/models/o_auth2_provider_list.py

@@ -44,6 +44,8 @@ from .o_auth2_okta import OAuth2Okta
 from .o_auth2_kick import OAuth2Kick
 from .o_auth2_microsoft import OAuth2Microsoft
 from .o_auth2_hugging_face import OAuth2HuggingFace
+from .o_auth2_resend import OAuth2Resend
+from .o_auth2_cloudflare import OAuth2Cloudflare
 
 
 class OAuth2ProviderList(AppwriteModel):
@@ -54,7 +56,7 @@ class OAuth2ProviderList(AppwriteModel):
     ----------
     total : float
         Total number of OAuth2 providers in the given project.
-    providers : List[Union[OAuth2Github, OAuth2Discord, OAuth2Figma, OAuth2Dropbox, OAuth2Dailymotion, OAuth2Bitbucket, OAuth2Bitly, OAuth2Box, OAuth2Autodesk, OAuth2Google, OAuth2Zoom, OAuth2Zoho, OAuth2Yandex, OAuth2X, OAuth2WordPress, OAuth2Twitch, OAuth2Stripe, OAuth2Spotify, OAuth2Slack, OAuth2Podio, OAuth2Notion, OAuth2Salesforce, OAuth2Yahoo, OAuth2Linkedin, OAuth2Disqus, OAuth2Amazon, OAuth2Etsy, OAuth2Facebook, OAuth2Tradeshift, OAuth2Paypal, OAuth2Gitlab, OAuth2Appwrite, OAuth2Authentik, OAuth2Auth0, OAuth2FusionAuth, OAuth2Keycloak, OAuth2Oidc, OAuth2Apple, OAuth2Okta, OAuth2Kick, OAuth2Microsoft, OAuth2HuggingFace]]
+    providers : List[Union[OAuth2Github, OAuth2Discord, OAuth2Figma, OAuth2Dropbox, OAuth2Dailymotion, OAuth2Bitbucket, OAuth2Bitly, OAuth2Box, OAuth2Autodesk, OAuth2Google, OAuth2Zoom, OAuth2Zoho, OAuth2Yandex, OAuth2X, OAuth2WordPress, OAuth2Twitch, OAuth2Stripe, OAuth2Spotify, OAuth2Slack, OAuth2Podio, OAuth2Notion, OAuth2Salesforce, OAuth2Yahoo, OAuth2Linkedin, OAuth2Disqus, OAuth2Amazon, OAuth2Etsy, OAuth2Facebook, OAuth2Tradeshift, OAuth2Paypal, OAuth2Gitlab, OAuth2Appwrite, OAuth2Authentik, OAuth2Auth0, OAuth2FusionAuth, OAuth2Keycloak, OAuth2Oidc, OAuth2Apple, OAuth2Okta, OAuth2Kick, OAuth2Microsoft, OAuth2HuggingFace, OAuth2Resend, OAuth2Cloudflare]]
         List of OAuth2 providers.
     """
 
@@ -103,5 +105,7 @@ class OAuth2ProviderList(AppwriteModel):
             OAuth2Kick,
             OAuth2Microsoft,
             OAuth2HuggingFace,
+            OAuth2Resend,
+            OAuth2Cloudflare,
         ]
     ] = Field(..., alias='providers')

appwrite-24.2.0/appwrite/models/o_auth2_resend.py

@@ -0,0 +1,26 @@
+from typing import Any, Dict, List, Optional, Union, cast
+from pydantic import Field, PrivateAttr
+
+from .base_model import AppwriteModel
+
+
+class OAuth2Resend(AppwriteModel):
+    """
+    OAuth2Resend
+
+    Attributes
+    ----------
+    id : str
+        OAuth2 provider ID.
+    enabled : bool
+        OAuth2 provider is active and can be used to create sessions.
+    clientid : str
+        Resend OAuth2 client ID.
+    clientsecret : str
+        Resend OAuth2 client secret.
+    """
+
+    id: str = Field(..., alias='$id')
+    enabled: bool = Field(..., alias='enabled')
+    clientid: str = Field(..., alias='clientId')
+    clientsecret: str = Field(..., alias='clientSecret')

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/account.py

@@ -1869,6 +1869,7 @@ class Account(Service):
         success: Optional[str] = None,
         failure: Optional[str] = None,
         scopes: Optional[List[str]] = None,
+        state: Optional[str] = None,
     ) -> str:
         """
         Allow the user to login to their account using the OAuth2 provider of their choice. Each OAuth2 provider should be enabled from the Appwrite console first. Use the success and failure arguments to provide a redirect URL's back to your app when login is completed.
@@ -1880,13 +1881,15 @@ class Account(Service):
         Parameters
         ----------
         provider : OAuthProvider
-            OAuth2 Provider. Currently, supported providers are: amazon, apple, appwrite, auth0, authentik, autodesk, bitbucket, bitly, box, dailymotion, discord, disqus, dropbox, etsy, facebook, figma, fusionauth, github, gitlab, google, huggingface, keycloak, kick, linkedin, microsoft, notion, oidc, okta, paypal, paypalSandbox, podio, salesforce, slack, spotify, stripe, tradeshift, tradeshiftBox, twitch, wordpress, x, yahoo, yammer, yandex, zoho, zoom.
+            OAuth2 Provider. Currently, supported providers are: amazon, apple, appwrite, auth0, authentik, autodesk, bitbucket, bitly, box, cloudflare, dailymotion, discord, disqus, dropbox, etsy, facebook, figma, fusionauth, github, gitlab, google, huggingface, keycloak, kick, linkedin, microsoft, notion, oidc, okta, paypal, paypalSandbox, podio, resend, salesforce, slack, spotify, stripe, tradeshift, tradeshiftBox, twitch, wordpress, x, yahoo, yammer, yandex, zoho, zoom.
         success : Optional[str]
             URL to redirect back to your app after a successful login attempt.  Only URLs from hostnames in your project's platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.
         failure : Optional[str]
             URL to redirect back to your app after a failed login attempt.  Only URLs from hostnames in your project's platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.
         scopes : Optional[List[str]]
             A list of custom OAuth2 scopes. Check each provider internal docs for a list of supported scopes. Maximum of 100 scopes are allowed, each 4096 characters long.
+        state : Optional[str]
+            An opaque value your app generates and keeps, for example in a cookie. It is returned unchanged as the `state` query parameter on the success and failure URLs, so your app can check that the sign-in it receives is one it started. Printable ASCII only (RFC 6749 Appendix A.5). Max length: 256 chars.
         Returns
         -------
         str
@@ -1909,6 +1912,8 @@ class Account(Service):
             api_params['failure'] = self._normalize_value(failure)
         if scopes is not None:
             api_params['scopes'] = self._normalize_value(scopes)
+        if state is not None:
+            api_params['state'] = self._normalize_value(state)
 
         response = self.client.call(
             'get',

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/avatars.py

@@ -356,7 +356,7 @@ class Avatars(Service):
         """
         Returns the best available profile photo for a user. The endpoint tries each source in priority order and returns the first successful result: OAuth2 identity photo, Gravatar, Libravatar, Appwrite Initials, built-in static fallback.
 
-        The photo resolves for the currently authenticated user unless `userId` points at another user. Passing `emailHash` and/or `name` resolves the avatar from those values alone: the hash is looked up on Gravatar and Libravatar, the name is rendered as initials, and the user's own identity photos, email, and name leave the chain so they never shadow the avatar being asked for. Emails are only ever accepted pre-hashed, so no address ends up in a URL.
+        Passing `userId` — `current()` for the authenticated user — resolves the photo from everything known about that user: identity photos, email, and name. An explicit `emailHash` or `name` then overrides just that value, and the user's remaining sources stay in the chain. Without `userId`, passing `emailHash` and/or `name` resolves the avatar from those values alone: the hash is looked up on Gravatar and Libravatar, the name is rendered as initials, and the session user stays out of the chain so their own photo never shadows the avatar being asked for. When nothing is passed, the photo resolves for the currently authenticated user. Emails are only ever accepted pre-hashed, so no address ends up in a URL.
 
         Parameters
         ----------
@@ -371,11 +371,11 @@ class Avatars(Service):
         rating : Optional[str]
             Maximum image rating to fetch from Gravatar/Libravatar. Defaults to 'g'.
         user_id : Optional[str]
-            User ID to resolve the photo for. Defaults to 'current()' for the currently authenticated user.
+            User ID to resolve the photo for. Pass 'current()' for the currently authenticated user. When omitted, the session user is used only if no emailHash and no name is passed.
         email_hash : Optional[str]
-            SHA256 hash of the lowercase, trimmed email address to look up on Gravatar and Libravatar instead of the user's own photo sources. Pass the hash, never the address itself.
+            SHA256 hash of the lowercase, trimmed email address to look up on Gravatar and Libravatar instead of the user's own email. Pass the hash, never the address itself.
         name : Optional[str]
-            Name to render initials from instead of the user's own photo sources. Max length: 128 chars.
+            Name to render initials from instead of the user's own name. Max length: 128 chars.
         Returns
         -------
         bytes

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/documents_db.py

@@ -949,6 +949,7 @@ class DocumentsDB(Service):
         document_id: str,
         data: Dict[str, Any],
         permissions: Optional[List[str]] = None,
+        transaction_id: Optional[str] = None,
         model_type: Type[T] = dict,
     ) -> Document[T]:
         """
@@ -966,6 +967,8 @@ class DocumentsDB(Service):
             Document data as JSON object.
         permissions : Optional[List[str]]
             An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).
+        transaction_id : Optional[str]
+            Transaction ID for staging the operation.
         model_type : Type[T], optional
             Pydantic model class for the user-defined data. Defaults to dict for backward compatibility.
 
@@ -996,6 +999,8 @@ class DocumentsDB(Service):
         api_params['data'] = self._normalize_value(data)
         if permissions is not None:
             api_params['permissions'] = self._normalize_value(permissions)
+        if transaction_id is not None:
+            api_params['transactionId'] = self._normalize_value(transaction_id)
 
         response = self.client.call(
             'post',
@@ -1015,6 +1020,7 @@ class DocumentsDB(Service):
         database_id: str,
         collection_id: str,
         documents: List[Dict[str, Any]],
+        transaction_id: Optional[str] = None,
         model_type: Type[T] = dict,
     ) -> DocumentList[T]:
         """
@@ -1028,6 +1034,8 @@ class DocumentsDB(Service):
             Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). Make sure to define attributes before creating documents.
         documents : List[Dict[str, Any]]
             Array of documents data as JSON objects.
+        transaction_id : Optional[str]
+            Transaction ID for staging the operation.
         model_type : Type[T], optional
             Pydantic model class for the user-defined data. Defaults to dict for backward compatibility.
 
@@ -1053,6 +1061,8 @@ class DocumentsDB(Service):
         api_path = api_path.replace('{databaseId}', str(self._normalize_value(database_id)))
         api_path = api_path.replace('{collectionId}', str(self._normalize_value(collection_id)))
         api_params['documents'] = self._normalize_value(documents)
+        if transaction_id is not None:
+            api_params['transactionId'] = self._normalize_value(transaction_id)
 
         response = self.client.call(
             'post',

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/functions.py

@@ -100,6 +100,7 @@ class Functions(Service):
         build_specification: Optional[str] = None,
         runtime_specification: Optional[str] = None,
         deployment_retention: Optional[float] = None,
+        interval: Optional[float] = None,
     ) -> Function:
         """
         Create a new function. You can pass a list of [permissions](https://appwrite.io/docs/permissions) to allow different project users or team with access to execute the function using the client API.
@@ -117,7 +118,7 @@ class Functions(Service):
         events : Optional[List[str]]
             Events list. Maximum of 100 events are allowed.
         schedule : Optional[str]
-            Schedule CRON syntax.
+            Schedule CRON syntax. Cannot be combined with interval.
         timeout : Optional[float]
             Function maximum execution time in seconds.
         enabled : Optional[bool]
@@ -150,6 +151,8 @@ class Functions(Service):
             Runtime specification for the function executions.
         deployment_retention : Optional[float]
             Days to keep non-active deployments before deletion. Value 0 means all deployments will be kept.
+        interval : Optional[float]
+            Minutes between scheduled executions. Appwrite picks when within each interval the function runs. Use 0 to disable. Cannot be combined with schedule.
         Returns
         -------
         Function
@@ -210,6 +213,8 @@ class Functions(Service):
             api_params['runtimeSpecification'] = self._normalize_value(runtime_specification)
         if deployment_retention is not None:
             api_params['deploymentRetention'] = self._normalize_value(deployment_retention)
+        if interval is not None:
+            api_params['interval'] = self._normalize_value(interval)
 
         response = self.client.call(
             'post',
@@ -358,6 +363,7 @@ class Functions(Service):
         build_specification: Optional[str] = None,
         runtime_specification: Optional[str] = None,
         deployment_retention: Optional[float] = None,
+        interval: Optional[float] = None,
     ) -> Function:
         """
         Update function by its unique ID.
@@ -375,7 +381,7 @@ class Functions(Service):
         events : Optional[List[str]]
             Events list. Maximum of 100 events are allowed.
         schedule : Optional[str]
-            Schedule CRON syntax.
+            Schedule CRON syntax. Cannot be combined with interval.
         timeout : Optional[float]
             Maximum execution time in seconds.
         enabled : Optional[bool]
@@ -408,6 +414,8 @@ class Functions(Service):
             Runtime specification for the function executions.
         deployment_retention : Optional[float]
             Days to keep non-active deployments before deletion. Value 0 means all deployments will be kept.
+        interval : Optional[float]
+            Minutes between scheduled executions. Appwrite picks when within each interval the function runs. Use 0 to disable. Cannot be combined with schedule. When omitted, the current interval is kept unless schedule is set.
         Returns
         -------
         Function
@@ -467,6 +475,8 @@ class Functions(Service):
             api_params['runtimeSpecification'] = self._normalize_value(runtime_specification)
         if deployment_retention is not None:
             api_params['deploymentRetention'] = self._normalize_value(deployment_retention)
+        if interval is not None:
+            api_params['interval'] = self._normalize_value(interval)
 
         response = self.client.call(
             'put',

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/mongo.py

@@ -12,6 +12,7 @@ from ..models.backup_policy_list import BackupPolicyList
 from ..models.backup_policy import BackupPolicy
 from ..models.dedicated_database_backup_storage import DedicatedDatabaseBackupStorage
 from ..models.dedicated_database_branch_list import DedicatedDatabaseBranchList
+from ..models.dedicated_database_operation import DedicatedDatabaseOperation
 from ..models.dedicated_database_operation_list import DedicatedDatabaseOperationList
 from ..models.dedicated_database_pitr_windows import DedicatedDatabasePITRWindows
 from ..models.dedicated_database_replicas import DedicatedDatabaseReplicas
@@ -1113,9 +1114,9 @@ class Mongo(Service):
     def update_credentials(
         self,
         database_id: str,
-    ) -> DedicatedDatabase:
+    ) -> DedicatedDatabaseOperation:
         """
-        Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+        Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
 
         Parameters
         ----------
@@ -1123,7 +1124,7 @@ class Mongo(Service):
             Database ID.
         Returns
         -------
-        DedicatedDatabase
+        DedicatedDatabaseOperation
             API response as a typed Pydantic model
 
         Raises
@@ -1149,7 +1150,7 @@ class Mongo(Service):
             api_params,
         )
 
-        return self._parse_response(response, model=DedicatedDatabase)
+        return self._parse_response(response, model=DedicatedDatabaseOperation)
 
     def create_failover(
         self,

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/mysql.py

@@ -12,6 +12,7 @@ from ..models.backup_policy_list import BackupPolicyList
 from ..models.backup_policy import BackupPolicy
 from ..models.dedicated_database_backup_storage import DedicatedDatabaseBackupStorage
 from ..models.dedicated_database_branch_list import DedicatedDatabaseBranchList
+from ..models.dedicated_database_operation import DedicatedDatabaseOperation
 from ..models.dedicated_database_execution import DedicatedDatabaseExecution
 from ..models.dedicated_database_operation_list import DedicatedDatabaseOperationList
 from ..models.dedicated_database_pitr_windows import DedicatedDatabasePITRWindows
@@ -1115,9 +1116,9 @@ class Mysql(Service):
     def update_credentials(
         self,
         database_id: str,
-    ) -> DedicatedDatabase:
+    ) -> DedicatedDatabaseOperation:
         """
-        Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+        Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
 
         Parameters
         ----------
@@ -1125,7 +1126,7 @@ class Mysql(Service):
             Database ID.
         Returns
         -------
-        DedicatedDatabase
+        DedicatedDatabaseOperation
             API response as a typed Pydantic model
 
         Raises
@@ -1151,7 +1152,7 @@ class Mysql(Service):
             api_params,
         )
 
-        return self._parse_response(response, model=DedicatedDatabase)
+        return self._parse_response(response, model=DedicatedDatabaseOperation)
 
     def create_execution(
         self,

{appwrite-24.0.0rc1 → appwrite-24.2.0}/appwrite/services/postgresql.py

@@ -12,6 +12,7 @@ from ..models.backup_policy_list import BackupPolicyList
 from ..models.backup_policy import BackupPolicy
 from ..models.dedicated_database_backup_storage import DedicatedDatabaseBackupStorage
 from ..models.dedicated_database_branch_list import DedicatedDatabaseBranchList
+from ..models.dedicated_database_operation import DedicatedDatabaseOperation
 from ..models.dedicated_database_execution import DedicatedDatabaseExecution
 from ..models.dedicated_database_extensions import DedicatedDatabaseExtensions
 from ..models.dedicated_database_operation_list import DedicatedDatabaseOperationList
@@ -1116,9 +1117,9 @@ class Postgresql(Service):
     def update_credentials(
         self,
         database_id: str,
-    ) -> DedicatedDatabase:
+    ) -> DedicatedDatabaseOperation:
         """
-        Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+        Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
 
         Parameters
         ----------
@@ -1126,7 +1127,7 @@ class Postgresql(Service):
             Database ID.
         Returns
         -------
-        DedicatedDatabase
+        DedicatedDatabaseOperation
             API response as a typed Pydantic model
 
         Raises
@@ -1152,7 +1153,7 @@ class Postgresql(Service):
             api_params,
         )
 
-        return self._parse_response(response, model=DedicatedDatabase)
+        return self._parse_response(response, model=DedicatedDatabaseOperation)
 
     def create_execution(
         self,