nightona 0.191.0

data/lib/nightona/common/resources.rb

@@ -0,0 +1,39 @@
+# Copyright Daytona Platforms Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# frozen_string_literal: true
+
+module Nightona
+  class Resources
+    # @return [Integer, nil] Number of CPU cores to allocate
+    attr_reader :cpu
+
+    # @return [Integer, nil] Amount of memory in GiB to allocate
+    attr_reader :memory
+
+    # @return [Integer, nil] Amount of disk space in GiB to allocate
+    attr_reader :disk
+
+    # @return [Integer, nil] Number of GPUs to allocate
+    attr_reader :gpu
+
+    # @return [String, Array<String>, nil] Preferred GPU type for the Sandbox
+    attr_reader :gpu_type
+
+    # @param cpu [Integer, nil] Number of CPU cores to allocate
+    # @param memory [Integer, nil] Amount of memory in GiB to allocate
+    # @param disk [Integer, nil] Amount of disk space in GiB to allocate
+    # @param gpu [Integer, nil] Number of GPUs to allocate
+    # @param gpu_type [String, Array<String>, nil] Preferred GPU type for the Sandbox
+    def initialize(cpu: nil, memory: nil, disk: nil, gpu: nil, gpu_type: nil)
+      @cpu = cpu
+      @memory = memory
+      @disk = disk
+      @gpu = gpu
+      @gpu_type = gpu_type
+    end
+
+    # @return [Hash] Hash representation of the resources
+    def to_h = { cpu:, memory:, disk:, gpu:, gpu_type: }.compact
+  end
+end

data/lib/nightona/common/response.rb

@@ -0,0 +1,83 @@
+# Copyright Daytona Platforms Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# frozen_string_literal: true
+
+module Nightona
+  # Re-export of api-client enum constants under the Nightona namespace so
+  # SDK consumers never need to import from NightonaApiClient directly.
+  SandboxClass = NightonaApiClient::SandboxClass
+  SandboxState = NightonaApiClient::SandboxState
+  SandboxListSortField = NightonaApiClient::SandboxListSortField
+  SandboxListSortDirection = NightonaApiClient::SandboxListSortDirection
+  GpuType = NightonaApiClient::GpuType
+
+  class PaginatedResource
+    # @return [Array<Object>]
+    attr_reader :items
+
+    # @return [Float]
+    attr_reader :page
+
+    # @return [Float]
+    attr_reader :total
+
+    # @return [Float]
+    attr_reader :total_pages
+
+    # @param items [Nightona::Sandbox]
+    # @param page [Float]
+    # @param total [Float]
+    # @param total_pages [Float]
+    def initialize(items:, page:, total:, total_pages:)
+      @items = items
+      @page = page
+      @total = total
+      @total_pages = total_pages
+    end
+  end
+
+  # Query parameters for filtering and sorting when listing Sandboxes.
+  #
+  # All fields are optional and default to +nil+. Constructed via keyword
+  # arguments and immutable (Ruby 3.2+ Data semantics).
+  #
+  # @example
+  #   query = Nightona::ListSandboxesQuery.new(labels: { 'env' => 'prod' }, limit: 10)
+  #   nightona.list(query).each { |sandbox| puts sandbox.id }
+  ListSandboxesQuery = Data.define(
+    :limit,
+    :id,
+    :name,
+    :labels,
+    :states,
+    :snapshots,
+    :targets,
+    :min_cpu,
+    :max_cpu,
+    :min_memory_gib,
+    :max_memory_gib,
+    :min_disk_gib,
+    :max_disk_gib,
+    :is_public,
+    :is_recoverable,
+    :created_at_after,
+    :created_at_before,
+    :last_activity_after,
+    :last_activity_before,
+    :sort,
+    :order
+  ) do
+    # All members default to nil so callers pass only the filters they care about.
+    DEFAULTS = members.to_h { |m| [m, nil] }.freeze
+
+    class << self
+      alias_method :_data_new, :new
+      def new(**attrs) = _data_new(**DEFAULTS, **attrs)
+    end
+
+    # Idiomatic Ruby boolean predicate aliases.
+    def public? = is_public
+    def recoverable? = is_recoverable
+  end
+end

data/lib/nightona/common/snapshot.rb

@@ -0,0 +1,124 @@
+# Copyright Daytona Platforms Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# frozen_string_literal: true
+
+module Nightona
+  class CreateSnapshotParams
+    # @return [String] Name of the snapshot
+    attr_reader :name
+
+    # @return [String, Nightona::Image] Image of the snapshot. If a string is provided,
+    #   it should be available on some registry. If an Image instance is provided,
+    #   it will be used to create a new image in Nightona.
+    attr_reader :image
+
+    # @return [Nightona::Resources, nil] Resources of the snapshot
+    attr_reader :resources
+
+    # @return [Array<String>, nil] Entrypoint of the snapshot
+    attr_reader :entrypoint
+
+    # @return [String, nil] ID of the region where the snapshot will be available.
+    #   Defaults to organization default region if not specified.
+    attr_reader :region_id
+
+    # @return [NightonaApiClient::SandboxClass, nil] Target sandbox class.
+    attr_reader :sandbox_class
+
+    # @param name [String] Name of the snapshot
+    # @param image [String, Nightona::Image] Image of the snapshot
+    # @param resources [Nightona::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 sandbox_class [NightonaApiClient::SandboxClass, nil] Target sandbox class
+    def initialize(name:, image:, resources: nil, entrypoint: nil, region_id: nil, sandbox_class: nil)
+      @name = name
+      @image = image
+      @resources = resources
+      @entrypoint = entrypoint
+      @region_id = region_id
+      @sandbox_class = sandbox_class
+    end
+  end
+
+  class Snapshot
+    # @return [String] Unique identifier for the Snapshot
+    attr_reader :id
+
+    # @return [String, nil] Organization ID of the Snapshot
+    attr_reader :organization_id
+
+    # @return [Boolean, nil] Whether the Snapshot is general
+    attr_reader :general
+
+    # @return [String] Name of the Snapshot
+    attr_reader :name
+
+    # @return [String] Name of the Image of the Snapshot
+    attr_reader :image_name
+
+    # @return [String] State of the Snapshot
+    attr_reader :state
+
+    # @return [Float, nil] Size of the Snapshot
+    attr_reader :size
+
+    # @return [Array<String>, nil] Entrypoint of the Snapshot
+    attr_reader :entrypoint
+
+    # @return [Float] CPU of the Snapshot
+    attr_reader :cpu
+
+    # @return [Float] GPU of the Snapshot
+    attr_reader :gpu
+
+    # @return [Float] Memory of the Snapshot in GiB
+    attr_reader :mem
+
+    # @return [Float] Disk of the Snapshot in GiB
+    attr_reader :disk
+
+    # @return [String, nil] Error reason of the Snapshot
+    attr_reader :error_reason
+
+    # @return [String] Timestamp when the Snapshot was created
+    attr_reader :created_at
+
+    # @return [String] Timestamp when the Snapshot was last updated
+    attr_reader :updated_at
+
+    # @return [String, nil] Timestamp when the Snapshot was last used
+    attr_reader :last_used_at
+
+    # @return [NightonaApiClient::BuildInfo, nil] Build information for the snapshot
+    attr_reader :build_info
+
+    # @param snapshot_dto [NightonaApiClient::SnapshotDto] The snapshot DTO from the API
+    def initialize(snapshot_dto) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+      @id = snapshot_dto.id
+      @organization_id = snapshot_dto.organization_id
+      @general = snapshot_dto.general
+      @name = snapshot_dto.name
+      @image_name = snapshot_dto.image_name
+      @state = snapshot_dto.state
+      @size = snapshot_dto.size
+      @entrypoint = snapshot_dto.entrypoint
+      @cpu = snapshot_dto.cpu
+      @gpu = snapshot_dto.gpu
+      @mem = snapshot_dto.mem
+      @disk = snapshot_dto.disk
+      @error_reason = snapshot_dto.error_reason
+      @created_at = snapshot_dto.created_at
+      @updated_at = snapshot_dto.updated_at
+      @last_used_at = snapshot_dto.last_used_at
+      @build_info = snapshot_dto.build_info
+    end
+
+    # Creates a Snapshot instance from a SnapshotDto
+    #
+    # @param dto [NightonaApiClient::SnapshotDto] The snapshot DTO from the API
+    # @return [Nightona::Snapshot] The snapshot instance
+    def self.from_dto(dto) = new(dto)
+  end
+end