daytona 0.223.1 → 0.224.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63db7dba8b656d1b2ba3c613a1ca9896211bf22b1c6430ed1d8e23e0e517a4c0
-  data.tar.gz: f8af7a09143410175e8936a76a1b8471578fded4267c5307b86cf3c9ddb1b834
+  metadata.gz: 9073174dfdaf41ddfeeff8c273346f9802806c7e39025f7efdf07eb5aaf32395
+  data.tar.gz: 27dcffd7cbeba0eabb88148108c5467995f16abb709820511c43a17a5568d8d5
 SHA512:
-  metadata.gz: 497a18b1e9bd0f6077bac4195f05af4cc814140a875c2ae4308957a5be8389cf474ba0b504da18e2fa4f8414333111b4f9f64151f5ed111334b9d82e0b531df9
-  data.tar.gz: ed9e925a0c2516974204f11229e655eae7e7ca1365e018160e7d6d0a17e2790f491c044e3242f48bfeb4e25a4dfb01d8d8455a7848303b1fc41c33fc8ba53d9a
+  metadata.gz: 958b391e87200ff87e0f643f3ddd66901b82d47528aaa2ec6986ea3726ac64e26474b3456a07146adb496c857daf3ca978c5a0793d954891cf350314ed0761fa
+  data.tar.gz: 381ecfdc0266799593abc3dc3aebbce9c077e41102852456c089f32e81f7992e4bad86231300378d6da5953edf78432f83d214cb288ebff0343fab755e274c25

data/README.md

@@ -30,7 +30,7 @@ Configure the SDK using [environment variables](https://www.daytona.io/docs/en/c
 
 - `DAYTONA_API_KEY`: Your Daytona [API key](https://www.daytona.io/docs/en/api-keys/)
 - `DAYTONA_API_URL`: The Daytona [API URL](https://www.daytona.io/docs/en/tools/api/)
-- `DAYTONA_TARGET`: Your target [region](https://www.daytona.io/docs/en/regions/) environment (e.g. `us`, `eu`)
+- `DAYTONA_TARGET`: Default [region](https://www.daytona.io/docs/en/regions/) for sandboxes and snapshots (e.g. `us`, `eu`); a per-call `target:` / `region_id:` overrides it
 
 ```ruby
 require 'daytona'
@@ -62,6 +62,20 @@ sandbox = daytona.create
 
 Daytona provides [examples](https://www.daytona.io/docs/en/getting-started/#examples) and [guides](https://www.daytona.io/docs/en/guides/) for common sandbox operations, best practices, and a wide range of topics, from basic usage to advanced topics, showcasing various types of integrations between Daytona and other tools.
 
+### Create a sandbox or snapshot in a specific region
+
+Pass `target:` in the sandbox create params, or `region_id:` in the snapshot create params, to choose the [region](https://www.daytona.io/docs/en/regions/) for that call. The region is resolved per call: the per-call value, then the client-level `target` (or `DAYTONA_TARGET`), then the organization's default region.
+
+```ruby
+require 'daytona'
+
+daytona = Daytona::Daytona.new
+sandbox = daytona.create(Daytona::CreateSandboxFromSnapshotParams.new(target: 'eu'))
+snapshot = daytona.snapshot.create(
+  Daytona::CreateSnapshotParams.new(name: 'my-snapshot', image: 'python:3.12', region_id: 'eu')
+)
+```
+
 ### Create a sandbox with custom resources
 
 Create a sandbox with [custom resources](https://www.daytona.io/docs/en/sandboxes/#resources) (CPU, memory, disk).

data/lib/daytona/common/daytona.rb

@@ -86,6 +86,11 @@ module Daytona
     #   ephemeral (auto_delete_interval=0) and cannot themselves be linked to another Sandbox.
     attr_accessor :linked_sandbox
 
+    # @return [String, nil] Target (region) where the Sandbox is created. Overrides the client-level
+    #   target for this call. If omitted, uses the client-level target when set; otherwise the
+    #   organization's default region.
+    attr_accessor :target
+
     # Initialize CreateSandboxBaseParams
     #
     # @param language [Symbol, nil] Programming language for the Sandbox
@@ -118,6 +123,8 @@ module Daytona
     # @param spot [Boolean, nil] GPU-only. Whether the Sandbox may be instantly terminated to free GPU
     #   capacity for an on-demand GPU Sandbox
     # @param linked_sandbox [String, nil] ID or name of an existing Sandbox to link the new Sandbox to
+    # @param target [String, nil] Target (region) where the Sandbox is created. Overrides the client-level
+    #   target for this call.
     def initialize( # rubocop:disable Metrics/MethodLength, Metrics/ParameterLists
       language: nil,
       os_user: nil,
@@ -141,7 +148,8 @@ module Daytona
       otel_endpoint_override: nil,
       ephemeral: nil,
       spot: nil,
-      linked_sandbox: nil
+      linked_sandbox: nil,
+      target: nil
     )
       @language = language
       @os_user = os_user
@@ -166,6 +174,7 @@ module Daytona
       @ephemeral = ephemeral
       @spot = spot
       @linked_sandbox = linked_sandbox
+      @target = target
 
       # Handle ephemeral and auto_delete_interval conflict
       handle_ephemeral_auto_delete_conflict
@@ -198,7 +207,8 @@ module Daytona
         otel_endpoint_override:,
         ephemeral:,
         spot:,
-        linked_sandbox:
+        linked_sandbox:,
+        target:
       }.compact
     end
 

data/lib/daytona/common/snapshot.rb

@@ -30,7 +30,8 @@ module Daytona
     # @param image [String, Daytona::Image] Image of the snapshot
     # @param resources [Daytona::Resources, nil] Resources of the snapshot
     # @param entrypoint [Array<String>, nil] Entrypoint of the snapshot
-    # @param region_id [String, nil] ID of the region where the snapshot will be available
+    # @param region_id [String, nil] ID of the region where the snapshot will be available. If omitted, uses
+    #   the client-level target when set; otherwise the organization's default region.
     # @param sandbox_class [DaytonaApiClient::SandboxClass, nil] Target sandbox class
     def initialize(name:, image:, resources: nil, entrypoint: nil, region_id: nil, sandbox_class: nil)
       @name = name

data/lib/daytona/config.rb

@@ -77,7 +77,8 @@ module Daytona
     # @return [String, nil] Daytona API URL
     attr_accessor :organization_id
 
-    # Target environment for sandboxes
+    # Default region for Sandboxes and Snapshots. A per-call `target:` (Sandbox create params) or
+    # `region_id:` (Snapshot create params) overrides it.
     #
     # @return [String, nil] Daytona target
     attr_accessor :target
@@ -108,7 +109,8 @@ module Daytona
     # @param jwt_token [String, nil] Daytona JWT token. Defaults to ENV['DAYTONA_JWT_TOKEN'].
     # @param api_url [String, nil] Daytona API URL. Defaults to ENV['DAYTONA_API_URL'] or Daytona::Config::API_URL.
     # @param organization_id [String, nil] Daytona organization ID. Defaults to ENV['DAYTONA_ORGANIZATION_ID'].
-    # @param target [String, nil] Daytona target. Defaults to ENV['DAYTONA_TARGET'].
+    # @param target [String, nil] Default region for Sandboxes and Snapshots; a per-call `target:` / `region_id:`
+    #   overrides it. Defaults to ENV['DAYTONA_TARGET'].
     # @param otel_enabled [Boolean, nil] Enable OpenTelemetry tracing for SDK operations.
     # @param use_deprecated_polling [Boolean, nil] Observe sandbox state by legacy polling instead of
     #   WebSocket event streaming. Defaults to false (event streaming). Can also be enabled via the

data/lib/daytona/daytona.rb

@@ -286,7 +286,7 @@ module Daytona
         env: params.env_vars || {},
         labels: labels,
         public: params.public,
-        target: config.target,
+        target: params.target.to_s.empty? ? config.target : params.target,
         auto_stop_interval: params.auto_stop_interval,
         auto_pause_interval: params.auto_pause_interval,
         auto_archive_interval: params.auto_archive_interval,

data/lib/daytona/sdk/version.rb

@@ -5,6 +5,6 @@
 
 module Daytona
   module Sdk
-    VERSION = '0.223.1'
+    VERSION = '0.224.0'
   end
 end

data/lib/daytona/snapshot_service.rb

@@ -117,7 +117,7 @@ module Daytona
         create_snapshot_req.disk = params.resources.disk
       end
 
-      create_snapshot_req.region_id = params.region_id || @default_region_id
+      create_snapshot_req.region_id = params.region_id.to_s.empty? ? @default_region_id : params.region_id
       create_snapshot_req.sandbox_class = params.sandbox_class
 
       snapshot = snapshots_api.create_snapshot(create_snapshot_req)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: daytona
 version: !ruby/object:Gem::Version
-  version: 0.223.1
+  version: 0.224.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
@@ -91,42 +91,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
 - !ruby/object:Gem::Dependency
   name: daytona_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
 - !ruby/object:Gem::Dependency
   name: daytona_toolbox_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.223.1
+        version: 0.224.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement