appwrite 28.4.0 → 29.0.0

data/lib/appwrite/services/activities.rb

@@ -43,13 +43,13 @@ module Appwrite
         def get_event(
             event_id:
         )
-            api_path = '/activities/events/{eventId}'
-                .gsub('{eventId}', event_id)
-
-            if event_id.nil?
+            if event_id.nil? || event_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "eventId"')
             end
 
+            api_path = '/activities/events/{eventId}'
+                .gsub('{eventId}', event_id)
+
             api_params = {}
 
             api_headers = {

data/lib/appwrite/services/advisor.rb

@@ -49,13 +49,13 @@ module Appwrite
         def get_report(
             report_id:
         )
-            api_path = '/reports/{reportId}'
-                .gsub('{reportId}', report_id)
-
-            if report_id.nil?
+            if report_id.nil? || report_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "reportId"')
             end
 
+            api_path = '/reports/{reportId}'
+                .gsub('{reportId}', report_id)
+
             api_params = {}
 
             api_headers = {
@@ -82,18 +82,19 @@ module Appwrite
         def delete_report(
             report_id:
         )
-            api_path = '/reports/{reportId}'
-                .gsub('{reportId}', report_id)
-
-            if report_id.nil?
+            if report_id.nil? || report_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "reportId"')
             end
 
+            api_path = '/reports/{reportId}'
+                .gsub('{reportId}', report_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
                 "content-type": 'application/json',
+                "accept": 'application/json',
             }
 
             @client.call(
@@ -118,13 +119,13 @@ module Appwrite
             queries: nil,
             total: nil
         )
-            api_path = '/reports/{reportId}/insights'
-                .gsub('{reportId}', report_id)
-
-            if report_id.nil?
+            if report_id.nil? || report_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "reportId"')
             end
 
+            api_path = '/reports/{reportId}/insights'
+                .gsub('{reportId}', report_id)
+
             api_params = {
                 queries: queries,
                 total: total,
@@ -155,18 +156,18 @@ module Appwrite
             report_id:,
             insight_id:
         )
-            api_path = '/reports/{reportId}/insights/{insightId}'
-                .gsub('{reportId}', report_id)
-                .gsub('{insightId}', insight_id)
-
-            if report_id.nil?
+            if report_id.nil? || report_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "reportId"')
             end
 
-            if insight_id.nil?
+            if insight_id.nil? || insight_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "insightId"')
             end
 
+            api_path = '/reports/{reportId}/insights/{insightId}'
+                .gsub('{reportId}', report_id)
+                .gsub('{insightId}', insight_id)
+
             api_params = {}
 
             api_headers = {

data/lib/appwrite/services/apps.rb

@@ -81,8 +81,6 @@ module Appwrite
             device_flow: nil,
             team_id: nil
         )
-            api_path = '/apps'
-
             if app_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
@@ -95,6 +93,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "redirectUris"')
             end
 
+            api_path = '/apps'
+
             api_params = {
                 appId: app_id,
                 name: name,
@@ -186,13 +186,13 @@ module Appwrite
         def get(
             app_id:
         )
-            api_path = '/apps/{appId}'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}'
+                .gsub('{appId}', app_id)
+
             api_params = {}
 
             api_headers = {
@@ -255,10 +255,7 @@ module Appwrite
             installation_scopes: nil,
             installation_redirect_url: nil
         )
-            api_path = '/apps/{appId}'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
@@ -266,6 +263,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/apps/{appId}'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 name: name,
                 description: description,
@@ -311,13 +311,13 @@ module Appwrite
         def delete(
             app_id:
         )
-            api_path = '/apps/{appId}'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}'
+                .gsub('{appId}', app_id)
+
             api_params = {}
 
             api_headers = {
@@ -348,13 +348,13 @@ module Appwrite
             queries: nil,
             total: nil
         )
-            api_path = '/apps/{appId}/installations'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/installations'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 queries: queries,
                 total: total,
@@ -386,18 +386,18 @@ module Appwrite
             app_id:,
             installation_id:
         )
-            api_path = '/apps/{appId}/installations/{installationId}'
-                .gsub('{appId}', app_id)
-                .gsub('{installationId}', installation_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if installation_id.nil?
+            if installation_id.nil? || installation_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "installationId"')
             end
 
+            api_path = '/apps/{appId}/installations/{installationId}'
+                .gsub('{appId}', app_id)
+                .gsub('{installationId}', installation_id)
+
             api_params = {}
 
             api_headers = {
@@ -426,18 +426,18 @@ module Appwrite
             app_id:,
             installation_id:
         )
-            api_path = '/apps/{appId}/installations/{installationId}'
-                .gsub('{appId}', app_id)
-                .gsub('{installationId}', installation_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if installation_id.nil?
+            if installation_id.nil? || installation_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "installationId"')
             end
 
+            api_path = '/apps/{appId}/installations/{installationId}'
+                .gsub('{appId}', app_id)
+                .gsub('{installationId}', installation_id)
+
             api_params = {}
 
             api_headers = {
@@ -471,18 +471,18 @@ module Appwrite
             app_id:,
             installation_id:
         )
-            api_path = '/apps/{appId}/installations/{installationId}/tokens'
-                .gsub('{appId}', app_id)
-                .gsub('{installationId}', installation_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if installation_id.nil?
+            if installation_id.nil? || installation_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "installationId"')
             end
 
+            api_path = '/apps/{appId}/installations/{installationId}/tokens'
+                .gsub('{appId}', app_id)
+                .gsub('{installationId}', installation_id)
+
             api_params = {}
 
             api_headers = {
@@ -512,13 +512,13 @@ module Appwrite
             queries: nil,
             total: nil
         )
-            api_path = '/apps/{appId}/keys'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/keys'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 queries: queries,
                 total: total,
@@ -548,13 +548,13 @@ module Appwrite
         def create_key(
             app_id:
         )
-            api_path = '/apps/{appId}/keys'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/keys'
+                .gsub('{appId}', app_id)
+
             api_params = {}
 
             api_headers = {
@@ -582,18 +582,18 @@ module Appwrite
             app_id:,
             key_id:
         )
-            api_path = '/apps/{appId}/keys/{keyId}'
-                .gsub('{appId}', app_id)
-                .gsub('{keyId}', key_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if key_id.nil?
+            if key_id.nil? || key_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "keyId"')
             end
 
+            api_path = '/apps/{appId}/keys/{keyId}'
+                .gsub('{appId}', app_id)
+                .gsub('{keyId}', key_id)
+
             api_params = {}
 
             api_headers = {
@@ -620,18 +620,18 @@ module Appwrite
             app_id:,
             key_id:
         )
-            api_path = '/apps/{appId}/keys/{keyId}'
-                .gsub('{appId}', app_id)
-                .gsub('{keyId}', key_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if key_id.nil?
+            if key_id.nil? || key_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "keyId"')
             end
 
+            api_path = '/apps/{appId}/keys/{keyId}'
+                .gsub('{appId}', app_id)
+                .gsub('{keyId}', key_id)
+
             api_params = {}
 
             api_headers = {
@@ -653,17 +653,14 @@ module Appwrite
         # labels.
         #
         # @param [String] app_id Application unique ID.
-        # @param [Array] labels Array of application labels. Replaces the previous labels. Maximum of 1000 labels are allowed, each up to 36 alphanumeric characters long.
+        # @param [Array] labels Array of application labels. Replaces the previous labels. Maximum of 1000 labels are allowed, each up to 36 alphanumeric characters long. Reserved labels are rejected.
         #
         # @return [App]
         def update_labels(
             app_id:,
             labels:
         )
-            api_path = '/apps/{appId}/labels'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
@@ -671,6 +668,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "labels"')
             end
 
+            api_path = '/apps/{appId}/labels'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 labels: labels,
             }
@@ -702,13 +702,13 @@ module Appwrite
             queries: nil,
             total: nil
         )
-            api_path = '/apps/{appId}/secrets'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/secrets'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 queries: queries,
                 total: total,
@@ -736,13 +736,13 @@ module Appwrite
         def create_secret(
             app_id:
         )
-            api_path = '/apps/{appId}/secrets'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/secrets'
+                .gsub('{appId}', app_id)
+
             api_params = {}
 
             api_headers = {
@@ -770,18 +770,18 @@ module Appwrite
             app_id:,
             secret_id:
         )
-            api_path = '/apps/{appId}/secrets/{secretId}'
-                .gsub('{appId}', app_id)
-                .gsub('{secretId}', secret_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if secret_id.nil?
+            if secret_id.nil? || secret_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "secretId"')
             end
 
+            api_path = '/apps/{appId}/secrets/{secretId}'
+                .gsub('{appId}', app_id)
+                .gsub('{secretId}', secret_id)
+
             api_params = {}
 
             api_headers = {
@@ -808,18 +808,18 @@ module Appwrite
             app_id:,
             secret_id:
         )
-            api_path = '/apps/{appId}/secrets/{secretId}'
-                .gsub('{appId}', app_id)
-                .gsub('{secretId}', secret_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
-            if secret_id.nil?
+            if secret_id.nil? || secret_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "secretId"')
             end
 
+            api_path = '/apps/{appId}/secrets/{secretId}'
+                .gsub('{appId}', app_id)
+                .gsub('{secretId}', secret_id)
+
             api_params = {}
 
             api_headers = {
@@ -846,10 +846,7 @@ module Appwrite
             app_id:,
             team_id:
         )
-            api_path = '/apps/{appId}/team'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
@@ -857,6 +854,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "teamId"')
             end
 
+            api_path = '/apps/{appId}/team'
+                .gsub('{appId}', app_id)
+
             api_params = {
                 teamId: team_id,
             }
@@ -884,13 +884,13 @@ module Appwrite
         def delete_tokens(
             app_id:
         )
-            api_path = '/apps/{appId}/tokens'
-                .gsub('{appId}', app_id)
-
-            if app_id.nil?
+            if app_id.nil? || app_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "appId"')
             end
 
+            api_path = '/apps/{appId}/tokens'
+                .gsub('{appId}', app_id)
+
             api_params = {}
 
             api_headers = {

data/lib/appwrite/services/avatars.rb

@@ -29,13 +29,13 @@ module Appwrite
             height: nil,
             quality: nil
         )
-            api_path = '/avatars/browsers/{code}'
-                .gsub('{code}', code)
-
             if code.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "code"')
             end
 
+            api_path = '/avatars/browsers/{code}'
+                .gsub('{code}', code)
+
             api_params = {
                 width: width,
                 height: height,
@@ -77,13 +77,13 @@ module Appwrite
             height: nil,
             quality: nil
         )
-            api_path = '/avatars/credit-cards/{code}'
-                .gsub('{code}', code)
-
             if code.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "code"')
             end
 
+            api_path = '/avatars/credit-cards/{code}'
+                .gsub('{code}', code)
+
             api_params = {
                 width: width,
                 height: height,
@@ -114,12 +114,12 @@ module Appwrite
         def get_favicon(
             url:
         )
-            api_path = '/avatars/favicon'
-
             if url.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "url"')
             end
 
+            api_path = '/avatars/favicon'
+
             api_params = {
                 url: url,
             }
@@ -160,13 +160,13 @@ module Appwrite
             height: nil,
             quality: nil
         )
-            api_path = '/avatars/flags/{code}'
-                .gsub('{code}', code)
-
             if code.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "code"')
             end
 
+            api_path = '/avatars/flags/{code}'
+                .gsub('{code}', code)
+
             api_params = {
                 width: width,
                 height: height,
@@ -208,12 +208,12 @@ module Appwrite
             width: nil,
             height: nil
         )
-            api_path = '/avatars/image'
-
             if url.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "url"')
             end
 
+            api_path = '/avatars/image'
+
             api_params = {
                 url: url,
                 width: width,
@@ -285,9 +285,9 @@ module Appwrite
         end
 
         # 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.
+        # each source in priority order and returns the first successful result: a
+        # custom uploaded photo (see avatars.updatePhoto), OAuth2 identity photo,
+        # Gravatar, Libravatar, Appwrite Initials, built-in static fallback.
         #
         # Passing `userId` — `current()` for the authenticated user — resolves
         # the photo from everything known about that user: identity photos, email,
@@ -433,12 +433,12 @@ module Appwrite
             margin: nil,
             download: nil
         )
-            api_path = '/avatars/qr'
-
             if text.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "text"')
             end
 
+            api_path = '/avatars/qr'
+
             api_params = {
                 text: text,
                 size: size,
@@ -471,7 +471,7 @@ module Appwrite
         # dimensions are not specified, the default viewport size is 1280x720px.
         #
         # @param [String] url Website URL which you want to capture.
-        # @param [Hash] headers HTTP headers to send with the browser request. Defaults to empty.
+        # @param [Hash] headers HTTP headers to send with the browser request. Only Accept and Accept-Language are allowed. Defaults to empty.
         # @param [Integer] viewport_width Browser viewport width. Pass an integer between 1 to 1920. Defaults to 1280.
         # @param [Integer] viewport_height Browser viewport height. Pass an integer between 1 to 1080. Defaults to 720.
         # @param [Float] scale Browser scale factor. Pass a number between 0.1 to 3. Defaults to 1.
@@ -514,12 +514,12 @@ module Appwrite
             quality: nil,
             output: nil
         )
-            api_path = '/avatars/screenshots'
-
             if url.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "url"')
             end
 
+            api_path = '/avatars/screenshots'
+
             api_params = {
                 url: url,
                 headers: headers,