wave-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 51569e29966120978d4c3b21eafbea0f5e8d259269d2866039225a1183e7e8cb
+  data.tar.gz: 8e00b241e35f45d21fee085627cd6c63b7752be372f204ef972615b2f2e13d2a
+SHA512:
+  metadata.gz: 04002e1d7c9e521a88ea79a0bf600ab12dea9d4d9d72d6c93d0ccebda8ee10b80970cb48562601a08f6dcf73760346ce72d1439e318fc9a3407ea36ca5541e7a
+  data.tar.gz: a8cf81ac371ec3b9886f075004a90e7ba01fdc6dda47f32733a75327aac18955be9e137c12b58fde116a028022300788c909736dc0e48985e2f19652538714bc

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WAVE Online, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,44 @@
+# WAVE SDK for Ruby
+
+Official Ruby client for the [WAVE](https://wave.online) API. Generated from the gateway OpenAPI
+contract. One gem, no runtime dependencies (stdlib `net/http`).
+
+```ruby
+gem "wave-sdk"
+```
+
+## Usage
+
+```ruby
+require "wave"
+
+client = Wave::Client.new("wave_live_...")
+
+clip = client.clips.get("clip_123")
+puts clip["title"]
+
+page = client.clips.list(video_id: "vid_1", per_page: 50)
+puts "#{page['data'].length} of #{page['pagination']['total']}"
+
+begin
+  client.clips.get("missing")
+rescue Wave::Error => e
+  warn "[#{e.code}] #{e.message} (status #{e.status_code})"
+end
+```
+
+## Notes
+
+- **Auth + entitlement** are enforced server-side at the gateway (`401`/`402`/`403`).
+- **Responses** are parsed JSON (`Hash` with string keys). Path params are positional, query params
+  are keyword args, request bodies are a `Hash`.
+- **Configuration:** `Wave::Client.new(key, base_url:, max_retries:, timeout:)`. Defaults: base
+  `https://api.wave.online/v1`, 3 retries, 30s timeout.
+- **Errors:** non-2xx → `Wave::Error`; `429` (after retries) → `Wave::RateLimitError`. Retries apply
+  to `429`/`5xx`/network with backoff + `Retry-After`.
+- **Generated** by `codegen/`; do not edit `lib/**` by hand.
+
+## Status
+
+`v0.1.0` — all 12 contract-frozen products (49 operations). New; not yet exercised against the live
+gateway end-to-end. Requires Ruby ≥ 3.0. License: MIT.

data/lib/wave/captions.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Wave
+  # Captions — Auto-captioning and multi-language translation
+  class Captions
+    def initialize(client)
+      @client = client
+    end
+
+    # List caption jobs (operationId: listCaptions, GET /captions).
+    def list(page: nil, per_page: nil, video_id: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "videoId" => video_id,
+        "status" => status,
+      }
+      @client.request("GET", "/captions", query: query)
+    end
+
+    # Create a caption job (operationId: createCaptionJob, POST /captions).
+    def create_job(body)
+      @client.request("POST", "/captions", body: body)
+    end
+
+    # Get a caption job (operationId: getCaptionJob, GET /captions/{jobId}).
+    def get_job(job_id)
+      @client.request("GET", "/captions/#{job_id}")
+    end
+
+    # Delete a caption job (operationId: deleteCaptionJob, DELETE /captions/{jobId}).
+    def delete_job(job_id)
+      @client.request("DELETE", "/captions/#{job_id}")
+    end
+
+    # Download captions (operationId: downloadCaptions, GET /captions/{jobId}/download).
+    def download(job_id, language, format: nil)
+      query = {
+        "language" => language,
+        "format" => format,
+      }
+      @client.request("GET", "/captions/#{job_id}/download", query: query)
+    end
+
+  end
+end

data/lib/wave/chapters.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Wave
+  # Chapters — AI chapter detection and video segmentation
+  class Chapters
+    def initialize(client)
+      @client = client
+    end
+
+    # List chapters for a video (operationId: listChapters, GET /videos/{videoId}/chapters).
+    def list(video_id)
+      @client.request("GET", "/videos/#{video_id}/chapters")
+    end
+
+    # Create a chapter (operationId: createChapter, POST /videos/{videoId}/chapters).
+    def create(video_id, body)
+      @client.request("POST", "/videos/#{video_id}/chapters", body: body)
+    end
+
+    # Start AI chapter detection (operationId: detectChapters, POST /videos/{videoId}/chapters/detect).
+    def detect(video_id, body)
+      @client.request("POST", "/videos/#{video_id}/chapters/detect", body: body)
+    end
+
+  end
+end

data/lib/wave/client.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module Wave
+  # HTTP client for the WAVE gateway. Handles auth, retries, and error parsing.
+  class Client
+    DEFAULT_BASE_URL = "https://api.wave.online/v1"
+    USER_AGENT = "wave-sdk-ruby/0.1.0"
+
+    def initialize(api_key, base_url: DEFAULT_BASE_URL, max_retries: 3, timeout: 30)
+      raise ArgumentError, "api_key is required" if api_key.nil? || api_key.to_s.empty?
+
+      @api_key = api_key
+      @base_url = base_url.to_s.chomp("/")
+      @max_retries = max_retries
+      @timeout = timeout
+    end
+
+    # Perform a request. Returns parsed JSON (Hash) or nil for 204/no body.
+    # Raises Wave::Error / Wave::RateLimitError on failure.
+    def request(method, path, query: nil, body: nil)
+      uri = URI("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(compact(query)) if query && !compact(query).empty?
+
+      attempt = 0
+      loop do
+        response = perform(method, uri, body)
+        status = response.code.to_i
+        request_id = response["x-request-id"]
+
+        if status == 429
+          retry_after = (response["Retry-After"] || "1").to_f
+          if attempt < @max_retries
+            sleep(retry_after)
+            attempt += 1
+            next
+          end
+          raise RateLimitError.new("rate limit exceeded", retry_after: retry_after, request_id: request_id)
+        end
+
+        if status >= 400
+          err = parse_error(response, status, request_id)
+          if err.retryable && attempt < @max_retries
+            sleep(backoff(attempt))
+            attempt += 1
+            next
+          end
+          raise err
+        end
+
+        return nil if status == 204 || response.body.nil? || response.body.empty?
+
+        content_type = response["Content-Type"].to_s
+        return JSON.parse(response.body) if content_type.start_with?("application/json")
+
+        return nil
+      rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, Net::OpenTimeout, Net::ReadTimeout, SocketError => e
+        if attempt < @max_retries
+          sleep(backoff(attempt))
+          attempt += 1
+          retry
+        end
+        raise Error.new(e.message, code: "NETWORK_ERROR", status_code: 0)
+      end
+    end
+
+    private
+
+    def perform(method, uri, body)
+      klass = {
+        "GET" => Net::HTTP::Get, "POST" => Net::HTTP::Post,
+        "PUT" => Net::HTTP::Put, "PATCH" => Net::HTTP::Patch,
+        "DELETE" => Net::HTTP::Delete
+      }.fetch(method)
+      req = klass.new(uri)
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Accept"] = "application/json"
+      req["User-Agent"] = USER_AGENT
+      unless body.nil?
+        req["Content-Type"] = "application/json"
+        req.body = JSON.generate(body)
+      end
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+      http.request(req)
+    end
+
+    def parse_error(response, status, request_id)
+      body = begin
+        JSON.parse(response.body.to_s)
+      rescue JSON::ParserError
+        {}
+      end
+      err = body["error"] || {}
+      Error.new(
+        err["message"] || "HTTP #{status}",
+        code: err["code"] || "HTTP_#{status}",
+        status_code: status,
+        request_id: request_id || body["request_id"],
+        details: err["details"]
+      )
+    end
+
+    def compact(hash)
+      (hash || {}).reject { |_, v| v.nil? }
+    end
+
+    def backoff(attempt)
+      delay = [2.0**attempt, 30.0].min
+      delay + (rand * delay * 0.25)
+    end
+  end
+end

data/lib/wave/clips.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Wave
+  # Clips — AI-powered highlight detection and clip management
+  class Clips
+    def initialize(client)
+      @client = client
+    end
+
+    # List clips (operationId: listClips, GET /clips).
+    def list(page: nil, per_page: nil, video_id: nil, status: nil, category: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "videoId" => video_id,
+        "status" => status,
+        "category" => category,
+      }
+      @client.request("GET", "/clips", query: query)
+    end
+
+    # Create a clip (operationId: createClip, POST /clips).
+    def create(body)
+      @client.request("POST", "/clips", body: body)
+    end
+
+    # Get a clip (operationId: getClip, GET /clips/{clipId}).
+    def get(clip_id)
+      @client.request("GET", "/clips/#{clip_id}")
+    end
+
+    # Update a clip (operationId: updateClip, PATCH /clips/{clipId}).
+    def update(clip_id, body)
+      @client.request("PATCH", "/clips/#{clip_id}", body: body)
+    end
+
+    # Delete a clip (operationId: deleteClip, DELETE /clips/{clipId}).
+    def delete(clip_id)
+      @client.request("DELETE", "/clips/#{clip_id}")
+    end
+
+    # Start AI clip detection (operationId: detectClips, POST /clips/detect).
+    def detect(body)
+      @client.request("POST", "/clips/detect", body: body)
+    end
+
+  end
+end

data/lib/wave/collab.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Wave
+  # Collab — Real-time collaboration rooms
+  class Collab
+    def initialize(client)
+      @client = client
+    end
+
+    # List collaboration rooms (operationId: listCollabRooms, GET /collab/rooms).
+    def list_rooms(page: nil, per_page: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "status" => status,
+      }
+      @client.request("GET", "/collab/rooms", query: query)
+    end
+
+    # Create a collaboration room (operationId: createCollabRoom, POST /collab/rooms).
+    def create_room(body)
+      @client.request("POST", "/collab/rooms", body: body)
+    end
+
+    # Get a room (operationId: getCollabRoom, GET /collab/rooms/{roomId}).
+    def get_room(room_id)
+      @client.request("GET", "/collab/rooms/#{room_id}")
+    end
+
+    # Delete a room (operationId: deleteCollabRoom, DELETE /collab/rooms/{roomId}).
+    def delete_room(room_id)
+      @client.request("DELETE", "/collab/rooms/#{room_id}")
+    end
+
+  end
+end

data/lib/wave/editor.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Wave
+  # Editor — Cloud video editing projects
+  class Editor
+    def initialize(client)
+      @client = client
+    end
+
+    # List editor projects (operationId: listProjects, GET /editor/projects).
+    def list_projects(page: nil, per_page: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "status" => status,
+      }
+      @client.request("GET", "/editor/projects", query: query)
+    end
+
+    # Create an editor project (operationId: createProject, POST /editor/projects).
+    def create_project(body)
+      @client.request("POST", "/editor/projects", body: body)
+    end
+
+    # Get a project (operationId: getProject, GET /editor/projects/{projectId}).
+    def get_project(project_id)
+      @client.request("GET", "/editor/projects/#{project_id}")
+    end
+
+    # Update a project (operationId: updateProject, PATCH /editor/projects/{projectId}).
+    def update_project(project_id, body)
+      @client.request("PATCH", "/editor/projects/#{project_id}", body: body)
+    end
+
+    # Delete a project (operationId: deleteProject, DELETE /editor/projects/{projectId}).
+    def delete_project(project_id)
+      @client.request("DELETE", "/editor/projects/#{project_id}")
+    end
+
+    # Export a project (operationId: exportProject, POST /editor/projects/{projectId}/export).
+    def export_project(project_id, body)
+      @client.request("POST", "/editor/projects/#{project_id}/export", body: body)
+    end
+
+  end
+end

data/lib/wave/errors.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Wave
+  # Canonical WAVE API error. The gateway emits a nested envelope
+  # {"error":{"code","message"}}; code/message are lifted from it.
+  class Error < StandardError
+    attr_reader :code, :status_code, :request_id, :details, :retryable
+
+    def initialize(message, code:, status_code:, request_id: nil, details: nil)
+      super(message)
+      @code = code
+      @status_code = status_code
+      @request_id = request_id
+      @details = details
+      @retryable = self.class.retryable?(status_code, code)
+    end
+
+    def self.retryable?(status_code, code)
+      return true if status_code == 429
+      return true if status_code >= 500 && status_code < 600
+
+      %w[TIMEOUT NETWORK_ERROR SERVICE_UNAVAILABLE].include?(code)
+    end
+  end
+
+  # Raised on HTTP 429 once the retry budget is exhausted.
+  class RateLimitError < Error
+    attr_reader :retry_after
+
+    def initialize(message, retry_after:, request_id: nil)
+      super(message, code: "RATE_LIMITED", status_code: 429, request_id: request_id)
+      @retry_after = retry_after
+    end
+  end
+end

data/lib/wave/phone.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Wave
+  # Phone — VoIP phone lines and call management
+  class Phone
+    def initialize(client)
+      @client = client
+    end
+
+    # List phone lines (operationId: listPhoneLines, GET /phone/lines).
+    def list_lines(page: nil, per_page: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+      }
+      @client.request("GET", "/phone/lines", query: query)
+    end
+
+    # Provision a phone line (operationId: provisionPhoneLine, POST /phone/lines).
+    def provision_line(body)
+      @client.request("POST", "/phone/lines", body: body)
+    end
+
+    # List calls (operationId: listCalls, GET /phone/calls).
+    def list_calls(page: nil, per_page: nil, line_id: nil, direction: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "lineId" => line_id,
+        "direction" => direction,
+      }
+      @client.request("GET", "/phone/calls", query: query)
+    end
+
+    # Make a call (operationId: makeCall, POST /phone/calls).
+    def make_call(body)
+      @client.request("POST", "/phone/calls", body: body)
+    end
+
+  end
+end

data/lib/wave/podcast.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Wave
+  # Podcast — Podcast show and episode management
+  class Podcast
+    def initialize(client)
+      @client = client
+    end
+
+    # List podcast shows (operationId: listPodcastShows, GET /podcast/shows).
+    def list_shows(page: nil, per_page: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+      }
+      @client.request("GET", "/podcast/shows", query: query)
+    end
+
+    # Create a podcast show (operationId: createPodcastShow, POST /podcast/shows).
+    def create_show(body)
+      @client.request("POST", "/podcast/shows", body: body)
+    end
+
+    # List episodes for a show (operationId: listPodcastEpisodes, GET /podcast/shows/{showId}/episodes).
+    def list_episodes(show_id, page: nil, per_page: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+      }
+      @client.request("GET", "/podcast/shows/#{show_id}/episodes", query: query)
+    end
+
+    # Create an episode (operationId: createPodcastEpisode, POST /podcast/shows/{showId}/episodes).
+    def create_episode(show_id, body)
+      @client.request("POST", "/podcast/shows/#{show_id}/episodes", body: body)
+    end
+
+  end
+end

data/lib/wave/search.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Wave
+  # Search — Semantic content search
+  class Search
+    def initialize(client)
+      @client = client
+    end
+
+    # Search content (operationId: search, POST /search).
+    def search(body)
+      @client.request("POST", "/search", body: body)
+    end
+
+    # Quick search (operationId: quickSearch, GET /search/quick).
+    def quick(q, limit: nil)
+      query = {
+        "q" => q,
+        "limit" => limit,
+      }
+      @client.request("GET", "/search/quick", query: query)
+    end
+
+    # Get search suggestions (operationId: searchSuggest, GET /search/suggest).
+    def suggest(q, limit: nil)
+      query = {
+        "q" => q,
+        "limit" => limit,
+      }
+      @client.request("GET", "/search/suggest", query: query)
+    end
+
+    # Semantic search (operationId: semanticSearch, POST /search/semantic).
+    def semantic(body)
+      @client.request("POST", "/search/semantic", body: body)
+    end
+
+  end
+end

data/lib/wave/sentiment.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Wave
+  # Sentiment — Sentiment and emotion analysis
+  class Sentiment
+    def initialize(client)
+      @client = client
+    end
+
+    # List sentiment analyses (operationId: listSentimentAnalyses, GET /sentiment).
+    def list_analyses(page: nil, per_page: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "status" => status,
+      }
+      @client.request("GET", "/sentiment", query: query)
+    end
+
+    # Create a sentiment analysis (operationId: createSentimentAnalysis, POST /sentiment).
+    def create_analysis(body)
+      @client.request("POST", "/sentiment", body: body)
+    end
+
+    # Analyze text directly (operationId: analyzeText, POST /sentiment/analyze).
+    def analyze_text(body)
+      @client.request("POST", "/sentiment/analyze", body: body)
+    end
+
+  end
+end

data/lib/wave/studio_ai.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Wave
+  # Studio AI — Video enhancement and AI processing
+  class StudioAi
+    def initialize(client)
+      @client = client
+    end
+
+    # List enhancement jobs (operationId: listEnhancements, GET /studio-ai/enhancements).
+    def list_enhancements(page: nil, per_page: nil, type: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "type" => type,
+        "status" => status,
+      }
+      @client.request("GET", "/studio-ai/enhancements", query: query)
+    end
+
+    # Create an enhancement job (operationId: createEnhancement, POST /studio-ai/enhancements).
+    def create_enhancement(body)
+      @client.request("POST", "/studio-ai/enhancements", body: body)
+    end
+
+    # Generate enhancement preview (operationId: previewEnhancement, POST /studio-ai/preview).
+    def preview_enhancement(body)
+      @client.request("POST", "/studio-ai/preview", body: body)
+    end
+
+  end
+end

data/lib/wave/transcribe.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Wave
+  # Transcribe — Speech-to-text transcription
+  class Transcribe
+    def initialize(client)
+      @client = client
+    end
+
+    # List transcriptions (operationId: listTranscriptions, GET /transcribe).
+    def list_transcriptions(page: nil, per_page: nil, status: nil)
+      query = {
+        "page" => page,
+        "perPage" => per_page,
+        "status" => status,
+      }
+      @client.request("GET", "/transcribe", query: query)
+    end
+
+    # Create a transcription (operationId: createTranscription, POST /transcribe).
+    def create_transcription(body)
+      @client.request("POST", "/transcribe", body: body)
+    end
+
+    # Get a transcription (operationId: getTranscription, GET /transcribe/{transcriptionId}).
+    def get_transcription(transcription_id)
+      @client.request("GET", "/transcribe/#{transcription_id}")
+    end
+
+    # Delete a transcription (operationId: deleteTranscription, DELETE /transcribe/{transcriptionId}).
+    def delete_transcription(transcription_id)
+      @client.request("DELETE", "/transcribe/#{transcription_id}")
+    end
+
+  end
+end

data/lib/wave/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Wave
+  VERSION = "0.1.0"
+end

data/lib/wave/voice.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Wave
+  # Voice — Text-to-speech synthesis and voice cloning
+  class Voice
+    def initialize(client)
+      @client = client
+    end
+
+    # List available voices (operationId: listVoices, GET /voice/voices).
+    def list(category: nil, language: nil)
+      query = {
+        "category" => category,
+        "language" => language,
+      }
+      @client.request("GET", "/voice/voices", query: query)
+    end
+
+    # Generate speech from text (operationId: generateSpeech, POST /voice/generate).
+    def generate_speech(body)
+      @client.request("POST", "/voice/generate", body: body)
+    end
+
+    # Clone a voice from audio samples (operationId: cloneVoice, POST /voice/clone).
+    def clone(body)
+      @client.request("POST", "/voice/clone", body: body)
+    end
+
+  end
+end

data/lib/wave.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require_relative "wave/version"
+require_relative "wave/errors"
+require_relative "wave/client"
+require_relative "wave/clips"
+require_relative "wave/voice"
+require_relative "wave/captions"
+require_relative "wave/chapters"
+require_relative "wave/editor"
+require_relative "wave/phone"
+require_relative "wave/collab"
+require_relative "wave/podcast"
+require_relative "wave/studio_ai"
+require_relative "wave/transcribe"
+require_relative "wave/sentiment"
+require_relative "wave/search"
+
+# Official WAVE API SDK for Ruby. Generated from the gateway OpenAPI contract.
+#
+#   client = Wave::Client.new("wave_live_...")
+#   clip = client.clips.get("clip_123")
+module Wave
+  class Client
+    # Access the Clips product.
+    def clips
+      Wave::Clips.new(self)
+    end
+
+    # Access the Voice product.
+    def voice
+      Wave::Voice.new(self)
+    end
+
+    # Access the Captions product.
+    def captions
+      Wave::Captions.new(self)
+    end
+
+    # Access the Chapters product.
+    def chapters
+      Wave::Chapters.new(self)
+    end
+
+    # Access the Editor product.
+    def editor
+      Wave::Editor.new(self)
+    end
+
+    # Access the Phone product.
+    def phone
+      Wave::Phone.new(self)
+    end
+
+    # Access the Collab product.
+    def collab
+      Wave::Collab.new(self)
+    end
+
+    # Access the Podcast product.
+    def podcast
+      Wave::Podcast.new(self)
+    end
+
+    # Access the Studio AI product.
+    def studio_ai
+      Wave::StudioAi.new(self)
+    end
+
+    # Access the Transcribe product.
+    def transcribe
+      Wave::Transcribe.new(self)
+    end
+
+    # Access the Sentiment product.
+    def sentiment
+      Wave::Sentiment.new(self)
+    end
+
+    # Access the Search product.
+    def search
+      Wave::Search.new(self)
+    end
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: wave-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- WAVE Inc.
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-01 00:00:00.000000000 Z
+dependencies: []
+description: Typed-ergonomic Ruby client for the WAVE API, generated from the gateway
+  OpenAPI contract.
+email:
+- sdk@wave.online
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/wave.rb
+- lib/wave/captions.rb
+- lib/wave/chapters.rb
+- lib/wave/client.rb
+- lib/wave/clips.rb
+- lib/wave/collab.rb
+- lib/wave/editor.rb
+- lib/wave/errors.rb
+- lib/wave/phone.rb
+- lib/wave/podcast.rb
+- lib/wave/search.rb
+- lib/wave/sentiment.rb
+- lib/wave/studio_ai.rb
+- lib/wave/transcribe.rb
+- lib/wave/version.rb
+- lib/wave/voice.rb
+homepage: https://wave.online
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/wave-av/sdks
+  homepage_uri: https://wave.online
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Official WAVE API SDK for Ruby
+test_files: []