daytona 0.202.0 → 0.203.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d211705ef263fa492b31a4e32ffc3a1d6ff3dbd2429baa2fc03dcc60012672b
-  data.tar.gz: 803fc638b4d11ac3c2435621f565967888ac68e1278081f382ad9977ec26aa94
+  metadata.gz: 57b147a70b0002de1953dcb42e98e4b5a1d6b6901637c5bc744905ae38e9e1f6
+  data.tar.gz: 1e08d695cb382017caf131b30f7679ed3701c6c14c6578cc00e53088a3e5d6d8
 SHA512:
-  metadata.gz: a73eb35713a3d7bc507b9f5ef8290a2230c9accc2efd17dc2c6d6a9dc452ce1ac12d1453caba8c61e175743b488e22ad4876be8093a6208465c5071b33844b5e
-  data.tar.gz: dbf474763c6e4254eba6bd65d7892a756879fd22f10401eb3576fc1ccb4b89c4fe4beeaa45bb6e611de1346a5507134e6c11a8f028991159f6f6cd60b4592231
+  metadata.gz: a6d5d0106b273bc5d0c457171624849b198a664d5ccd39924f79501d0cec11151fb2772f070f3a3a4064d89e6fc9966803fcab0409a5ea25cbbd816e85f12b77
+  data.tar.gz: 39d104c6d0d132034bd8453546e75b3675a801f9162051591ac74b94c4045ad268b4917a514ed5d831cd47bc670804eef0b054ceda75f159646976c8ca92fac4

data/README.md

@@ -6,12 +6,20 @@ The SDK provides an interface for sandbox management, file system operations, Gi
 
 ## Installation
 
+Requires **Ruby >= 3.2**. Check your version with `ruby -v` before installing — on older versions the install fails with a Bundler/RubyGems resolver error rather than a clear message.
+
 Install the package using **gem**:
 
 ```bash
 gem install daytona
 ```
 
+or add it to your **Gemfile**:
+
+```ruby
+gem 'daytona'
+```
+
 ## Get API key
 
 Generate an API key from the [Daytona Dashboard ↗](https://app.daytona.io/dashboard/keys) to authenticate SDK requests and access Daytona services. For more information, see the [API keys](https://www.daytona.io/docs/en/api-keys/) documentation.
@@ -182,3 +190,45 @@ completions = lsp_server.completions(
   position: Daytona::LspServer::Position.new(line: 10, character: 15)
 )
 ```
+
+## List method return shapes
+
+Each `list` method returns a different shape depending on the resource. The table below shows the exact return type and how to access the elements.
+
+| Method | Return type | Shape | Access elements |
+| --- | --- | --- | --- |
+| `daytona.snapshot.list(page:, limit:)` | `Daytona::PaginatedResource` | Paginated wrapper | `result.items.each` |
+| `daytona.secret.list(cursor:, limit:, ...)` | `Daytona::ListSecretsResponse` | Cursor-paginated wrapper | `page.items.each` |
+| `daytona.volume.list` | `Array<Daytona::Volume>` | Bare array | iterate directly |
+| `daytona.list(query)` | `Enumerator<Daytona::Sandbox>` | Lazy enumerator | `.each { \|s\| ... }` |
+
+`PaginatedResource` and `ListSecretsResponse` are **wrapper objects**, not arrays. Calling `.each` or `.map` directly on them raises `NoMethodError`. Always go through `.items`:
+
+```ruby
+# snapshots — page-number pagination
+result = daytona.snapshot.list(page: 1, limit: 20)
+# result.items       => Array<Daytona::Snapshot>
+# result.total       => Float (total across all pages)
+# result.page        => Float (current page, 1-indexed)
+# result.total_pages => Float
+result.items.each { |snapshot| puts "#{snapshot.name} (#{snapshot.image_name})" }
+
+# secrets — cursor pagination
+cursor = nil
+loop do
+  page = daytona.secret.list(cursor: cursor, limit: 100)
+  # page.items       => Array<Daytona::Secret>
+  # page.total       => Float
+  # page.next_cursor => String | nil (nil = no more pages)
+  page.items.each { |secret| puts secret.name }
+  cursor = page.next_cursor
+  break if cursor.nil?
+end
+
+# volumes — bare array, iterate directly
+daytona.volume.list.each { |vol| puts vol.name }
+
+# sandboxes — lazy enumerator, fetches pages on demand
+query = Daytona::ListSandboxesQuery.new(labels: { 'env' => 'dev' })
+daytona.list(query).each { |sandbox| puts sandbox.id }
+```

data/lib/daytona/sdk/errors.rb

@@ -125,6 +125,12 @@ module Daytona
     class FileNotFoundError < NotFoundError; end
     class FileAccessDeniedError < ForbiddenError; end
 
+    # The supplied file path was rejected by the daemon (code `INVALID_FILE_PATH`).
+    class InvalidFilePathError < BadRequestError; end
+
+    # The daemon could not read the sandbox file (code `FILE_READ_FAILED`).
+    class FileReadFailedError < InternalServerError; end
+
     # Daemon: LSP
     class LspServerNotInitializedError < BadRequestError; end
 
@@ -175,6 +181,8 @@ module Daytona
       # Daemon: filesystem
       [SOURCE_DAEMON, 'FILE_NOT_FOUND'] => FileNotFoundError,
       [SOURCE_DAEMON, 'FILE_ACCESS_DENIED'] => FileAccessDeniedError,
+      [SOURCE_DAEMON, 'INVALID_FILE_PATH'] => InvalidFilePathError,
+      [SOURCE_DAEMON, 'FILE_READ_FAILED'] => FileReadFailedError,
 
       # Daemon: LSP
       [SOURCE_DAEMON, 'LSP_SERVER_NOT_INITIALIZED'] => LspServerNotInitializedError,

data/lib/daytona/sdk/version.rb

@@ -5,6 +5,6 @@
 
 module Daytona
   module Sdk
-    VERSION = '0.202.0'
+    VERSION = '0.203.0'
   end
 end

data/lib/daytona/secret_service.rb

@@ -66,7 +66,8 @@ module Daytona
     #   cursor = nil
     #   loop do
     #     page = daytona.secret.list(cursor:, limit: 100)
-    #     page.items.each { |secret| puts secret.name }
+    #     puts "Fetched #{page.items.length} of #{page.total} secrets"
+    #     page.items.each { |secret| puts "#{secret.name} (#{secret.id})" }
     #     cursor = page.next_cursor
     #     break if cursor.nil?
     #   end

data/lib/daytona/snapshot_service.rb

@@ -31,8 +31,9 @@ module Daytona
     #
     # @example
     #   daytona = Daytona::Daytona.new
-    #   response = daytona.snapshot.list(page: 1, limit: 10)
-    #   snapshots.items.each { |snapshot| puts "#{snapshot.name} (#{snapshot.image_name})" }
+    #   page = daytona.snapshot.list(page: 2, limit: 10)
+    #   puts "Page #{page.page} of #{page.total_pages} (#{page.total} snapshots total)"
+    #   page.items.each { |snapshot| puts "#{snapshot.name} (#{snapshot.image_name})" }
     def list(page: nil, limit: nil)
       raise Sdk::Error, 'page must be positive integer' if page && page < 1
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: daytona
 version: !ruby/object:Gem::Version
-  version: 0.202.0
+  version: 0.203.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
@@ -85,42 +85,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
 - !ruby/object:Gem::Dependency
   name: daytona_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
 - !ruby/object:Gem::Dependency
   name: daytona_toolbox_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.202.0
+        version: 0.203.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -184,7 +184,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.6'
 description: 'High-level Ruby SDK for Daytona: sandboxes, git, filesystem, LSP, process,
-  and object storage.'
+  and object storage. Requires Ruby >= 3.2.'
 email:
 - support@daytona.io
 executables: []