feat: add method to service

ChiragAgg5k · ChiragAgg5k · commit 2520f03112e8 · 2025-11-28T19:05:26.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Change Log
 
+## 19.4.0
+
+* Add `get_screenshot` method to `Avatars` service
+
 ## 19.3.0
 
 * Add `total` parameter to list queries allowing skipping counting rows in a table for improved performance
diff --git a/appwrite.gemspec b/appwrite.gemspec
@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
 
   spec.name = 'appwrite'
-  spec.version = '19.3.0'
+  spec.version = '19.4.0'
   spec.license = 'BSD-3-Clause'
   spec.summary = 'Appwrite is an open-source self-hosted backend server that abstract and simplify complex and repetitive development tasks behind a very simple REST API'
   spec.author = 'Appwrite Team'
diff --git a/docs/examples/avatars/get-screenshot.md b/docs/examples/avatars/get-screenshot.md
@@ -0,0 +1,34 @@
+require 'appwrite'
+
+include Appwrite
+include Appwrite::Enums
+
+client = Client.new
+    .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
+    .set_project('<YOUR_PROJECT_ID>') # Your project ID
+    .set_session('') # The user session to authenticate with
+
+avatars = Avatars.new(client)
+
+result = avatars.get_screenshot(
+    url: 'https://example.com',
+    headers: {}, # optional
+    viewport_width: 1, # optional
+    viewport_height: 1, # optional
+    scale: 0.1, # optional
+    theme: Theme::LIGHT, # optional
+    user_agent: '<USER_AGENT>', # optional
+    fullpage: false, # optional
+    locale: '<LOCALE>', # optional
+    timezone: Timezone::AFRICA_ABIDJAN, # optional
+    latitude: -90, # optional
+    longitude: -180, # optional
+    accuracy: 0, # optional
+    touch: false, # optional
+    permissions: [], # optional
+    sleep: 0, # optional
+    width: 0, # optional
+    height: 0, # optional
+    quality: -1, # optional
+    output: Output::JPG # optional
+)
diff --git a/docs/examples/databases/update-relationship-attribute.md b/docs/examples/databases/update-relationship-attribute.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/functions/create-execution.md b/docs/examples/functions/create-execution.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/functions/create-template-deployment.md b/docs/examples/functions/create-template-deployment.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -14,6 +15,7 @@ result = functions.create_template_deployment(
     repository: '<REPOSITORY>',
     owner: '<OWNER>',
     root_directory: '<ROOT_DIRECTORY>',
-    version: '<VERSION>',
+    type: TemplateReferenceType::COMMIT,
+    reference: '<REFERENCE>',
     activate: false # optional
 )
diff --git a/docs/examples/functions/create-vcs-deployment.md b/docs/examples/functions/create-vcs-deployment.md
@@ -12,7 +12,7 @@ functions = Functions.new(client)
 
 result = functions.create_vcs_deployment(
     function_id: '<FUNCTION_ID>',
-    type: VCSDeploymentType::BRANCH,
+    type: VCSReferenceType::BRANCH,
     reference: '<REFERENCE>',
     activate: false # optional
 )
diff --git a/docs/examples/functions/create.md b/docs/examples/functions/create.md
@@ -13,7 +13,7 @@ functions = Functions.new(client)
 result = functions.create(
     function_id: '<FUNCTION_ID>',
     name: '<NAME>',
-    runtime: ::NODE_14_5,
+    runtime: Runtime::NODE_14_5,
     execute: ["any"], # optional
     events: [], # optional
     schedule: '', # optional
diff --git a/docs/examples/functions/get-deployment-download.md b/docs/examples/functions/get-deployment-download.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/functions/update.md b/docs/examples/functions/update.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -12,7 +13,7 @@ functions = Functions.new(client)
 result = functions.update(
     function_id: '<FUNCTION_ID>',
     name: '<NAME>',
-    runtime: ::NODE_14_5, # optional
+    runtime: Runtime::NODE_14_5, # optional
     execute: ["any"], # optional
     events: [], # optional
     schedule: '', # optional
diff --git a/docs/examples/health/get-failed-jobs.md b/docs/examples/health/get-failed-jobs.md
@@ -11,6 +11,6 @@ client = Client.new
 health = Health.new(client)
 
 result = health.get_failed_jobs(
-    name: ::V1_DATABASE,
+    name: Name::V1_DATABASE,
     threshold: null # optional
 )
diff --git a/docs/examples/messaging/create-push.md b/docs/examples/messaging/create-push.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/messaging/create-smtp-provider.md b/docs/examples/messaging/create-smtp-provider.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/messaging/update-push.md b/docs/examples/messaging/update-push.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/messaging/update-smtp-provider.md b/docs/examples/messaging/update-smtp-provider.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/sites/create-template-deployment.md b/docs/examples/sites/create-template-deployment.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -14,6 +15,7 @@ result = sites.create_template_deployment(
     repository: '<REPOSITORY>',
     owner: '<OWNER>',
     root_directory: '<ROOT_DIRECTORY>',
-    version: '<VERSION>',
+    type: TemplateReferenceType::BRANCH,
+    reference: '<REFERENCE>',
     activate: false # optional
 )
diff --git a/docs/examples/sites/create-vcs-deployment.md b/docs/examples/sites/create-vcs-deployment.md
@@ -12,7 +12,7 @@ sites = Sites.new(client)
 
 result = sites.create_vcs_deployment(
     site_id: '<SITE_ID>',
-    type: VCSDeploymentType::BRANCH,
+    type: VCSReferenceType::BRANCH,
     reference: '<REFERENCE>',
     activate: false # optional
 )
diff --git a/docs/examples/sites/create.md b/docs/examples/sites/create.md
@@ -13,15 +13,15 @@ sites = Sites.new(client)
 result = sites.create(
     site_id: '<SITE_ID>',
     name: '<NAME>',
-    framework: ::ANALOG,
-    build_runtime: ::NODE_14_5,
+    framework: Framework::ANALOG,
+    build_runtime: BuildRuntime::NODE_14_5,
     enabled: false, # optional
     logging: false, # optional
     timeout: 1, # optional
     install_command: '<INSTALL_COMMAND>', # optional
     build_command: '<BUILD_COMMAND>', # optional
     output_directory: '<OUTPUT_DIRECTORY>', # optional
-    adapter: ::STATIC, # optional
+    adapter: Adapter::STATIC, # optional
     installation_id: '<INSTALLATION_ID>', # optional
     fallback_file: '<FALLBACK_FILE>', # optional
     provider_repository_id: '<PROVIDER_REPOSITORY_ID>', # optional
diff --git a/docs/examples/sites/get-deployment-download.md b/docs/examples/sites/get-deployment-download.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/sites/update.md b/docs/examples/sites/update.md
@@ -13,15 +13,15 @@ sites = Sites.new(client)
 result = sites.update(
     site_id: '<SITE_ID>',
     name: '<NAME>',
-    framework: ::ANALOG,
+    framework: Framework::ANALOG,
     enabled: false, # optional
     logging: false, # optional
     timeout: 1, # optional
     install_command: '<INSTALL_COMMAND>', # optional
     build_command: '<BUILD_COMMAND>', # optional
     output_directory: '<OUTPUT_DIRECTORY>', # optional
-    build_runtime: ::NODE_14_5, # optional
-    adapter: ::STATIC, # optional
+    build_runtime: BuildRuntime::NODE_14_5, # optional
+    adapter: Adapter::STATIC, # optional
     fallback_file: '<FALLBACK_FILE>', # optional
     installation_id: '<INSTALLATION_ID>', # optional
     provider_repository_id: '<PROVIDER_REPOSITORY_ID>', # optional
diff --git a/docs/examples/storage/create-bucket.md b/docs/examples/storage/create-bucket.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 include Appwrite::Permission
 include Appwrite::Role
 
@@ -19,7 +20,8 @@ result = storage.create_bucket(
     enabled: false, # optional
     maximum_file_size: 1, # optional
     allowed_file_extensions: [], # optional
-    compression: ::NONE, # optional
+    compression: Compression::NONE, # optional
     encryption: false, # optional
-    antivirus: false # optional
+    antivirus: false, # optional
+    transformations: false # optional
 )
diff --git a/docs/examples/storage/get-file-preview.md b/docs/examples/storage/get-file-preview.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/storage/update-bucket.md b/docs/examples/storage/update-bucket.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 include Appwrite::Permission
 include Appwrite::Role
 
@@ -19,7 +20,8 @@ result = storage.update_bucket(
     enabled: false, # optional
     maximum_file_size: 1, # optional
     allowed_file_extensions: [], # optional
-    compression: ::NONE, # optional
+    compression: Compression::NONE, # optional
     encryption: false, # optional
-    antivirus: false # optional
+    antivirus: false, # optional
+    transformations: false # optional
 )
diff --git a/docs/examples/tablesdb/update-relationship-column.md b/docs/examples/tablesdb/update-relationship-column.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/docs/examples/users/create-sha-user.md b/docs/examples/users/create-sha-user.md
@@ -1,6 +1,7 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Enums
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
diff --git a/lib/appwrite.rb b/lib/appwrite.rb
@@ -142,11 +142,15 @@
 require_relative 'appwrite/enums/browser'
 require_relative 'appwrite/enums/credit_card'
 require_relative 'appwrite/enums/flag'
+require_relative 'appwrite/enums/theme'
+require_relative 'appwrite/enums/timezone'
+require_relative 'appwrite/enums/output'
 require_relative 'appwrite/enums/relationship_type'
 require_relative 'appwrite/enums/relation_mutate'
 require_relative 'appwrite/enums/index_type'
 require_relative 'appwrite/enums/runtime'
-require_relative 'appwrite/enums/vcs_deployment_type'
+require_relative 'appwrite/enums/template_reference_type'
+require_relative 'appwrite/enums/vcs_reference_type'
 require_relative 'appwrite/enums/deployment_download_type'
 require_relative 'appwrite/enums/execution_method'
 require_relative 'appwrite/enums/name'
diff --git a/lib/appwrite/client.rb b/lib/appwrite/client.rb
@@ -15,7 +15,7 @@ def initialize
                 'x-sdk-name'=> 'Ruby',
                 'x-sdk-platform'=> 'server',
                 'x-sdk-language'=> 'ruby',
-                'x-sdk-version'=> '19.3.0',
+                'x-sdk-version'=> '19.4.0',
                 'X-Appwrite-Response-Format' => '1.8.0'
             }
             @endpoint = 'https://cloud.appwrite.io/v1'
diff --git a/lib/appwrite/enums/build_runtime.rb b/lib/appwrite/enums/build_runtime.rb
@@ -39,6 +39,7 @@ module BuildRuntime
             DART_3_3 = 'dart-3.3'
             DART_3_5 = 'dart-3.5'
             DART_3_8 = 'dart-3.8'
+            DART_3_9 = 'dart-3.9'
             DOTNET_6_0 = 'dotnet-6.0'
             DOTNET_7_0 = 'dotnet-7.0'
             DOTNET_8_0 = 'dotnet-8.0'
@@ -66,6 +67,7 @@ module BuildRuntime
             FLUTTER_3_27 = 'flutter-3.27'
             FLUTTER_3_29 = 'flutter-3.29'
             FLUTTER_3_32 = 'flutter-3.32'
+            FLUTTER_3_35 = 'flutter-3.35'
         end
     end
 end
diff --git a/lib/appwrite/enums/output.rb b/lib/appwrite/enums/output.rb
@@ -0,0 +1,13 @@
+module Appwrite
+    module Enums
+        module Output
+            JPG = 'jpg'
+            JPEG = 'jpeg'
+            PNG = 'png'
+            WEBP = 'webp'
+            HEIC = 'heic'
+            AVIF = 'avif'
+            GIF = 'gif'
+        end
+    end
+end
diff --git a/lib/appwrite/enums/runtime.rb b/lib/appwrite/enums/runtime.rb
@@ -39,6 +39,7 @@ module Runtime
             DART_3_3 = 'dart-3.3'
             DART_3_5 = 'dart-3.5'
             DART_3_8 = 'dart-3.8'
+            DART_3_9 = 'dart-3.9'
             DOTNET_6_0 = 'dotnet-6.0'
             DOTNET_7_0 = 'dotnet-7.0'
             DOTNET_8_0 = 'dotnet-8.0'
@@ -66,6 +67,7 @@ module Runtime
             FLUTTER_3_27 = 'flutter-3.27'
             FLUTTER_3_29 = 'flutter-3.29'
             FLUTTER_3_32 = 'flutter-3.32'
+            FLUTTER_3_35 = 'flutter-3.35'
         end
     end
 end
diff --git a/lib/appwrite/enums/template_reference_type.rb b/lib/appwrite/enums/template_reference_type.rb
@@ -0,0 +1,9 @@
+module Appwrite
+    module Enums
+        module TemplateReferenceType
+            BRANCH = 'branch'
+            COMMIT = 'commit'
+            TAG = 'tag'
+        end
+    end
+end
diff --git a/lib/appwrite/enums/theme.rb b/lib/appwrite/enums/theme.rb
@@ -0,0 +1,8 @@
+module Appwrite
+    module Enums
+        module Theme
+            LIGHT = 'light'
+            DARK = 'dark'
+        end
+    end
+end
diff --git a/lib/appwrite/enums/timezone.rb b/lib/appwrite/enums/timezone.rb
diff --git a/lib/appwrite/enums/vcs_reference_type.rb b/lib/appwrite/enums/vcs_reference_type.rb
diff --git a/lib/appwrite/models/bucket.rb b/lib/appwrite/models/bucket.rb
diff --git a/lib/appwrite/services/avatars.rb b/lib/appwrite/services/avatars.rb
diff --git a/lib/appwrite/services/functions.rb b/lib/appwrite/services/functions.rb
diff --git a/lib/appwrite/services/sites.rb b/lib/appwrite/services/sites.rb
diff --git a/lib/appwrite/services/storage.rb b/lib/appwrite/services/storage.rb
diff --git a/lib/appwrite/services/tables_db.rb b/lib/appwrite/services/tables_db.rb

Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@ functions = Functions.new(client)`
`12`	`12`
`13`	`13`	`result = functions.create_vcs_deployment(`
`14`	`14`	`function_id: '<FUNCTION_ID>',`
`15`		`- type: VCSDeploymentType::BRANCH,`
	`15`	`+ type: VCSReferenceType::BRANCH,`
`16`	`16`	`reference: '<REFERENCE>',`
`17`	`17`	`activate: false # optional`
`18`	`18`	`)`