runapi-suno 0.2.7 → 0.2.9

data/lib/runapi/suno/validators.rb

@@ -5,15 +5,8 @@ module RunApi
     module Validators
       module_function
 
-      MUSIC_PROMPT_SHAPE_ERROR = "choose a valid vocal_mode: auto_lyrics, exact_lyrics, or instrumental"
-
       def validate_text_to_music!(params, resource)
-        validate_music_prompt_shape!(params, resource)
-        require_param!(resource, params, :model)
-        validate_optional!(resource, params, :vocal_mode, Types::VOCAL_MODES)
-        validate_optional!(resource, params, :model, Types::MODELS)
-        validate_optional!(resource, params, :vocal_gender, Types::VOCAL_GENDERS)
-        validate_optional!(resource, params, :persona_type, Types::PERSONA_TYPES)
+        resource.send(:validate_contract!, CONTRACT["text-to-music"], params)
       end
 
       def validate_extend_music!(params, resource)
@@ -40,13 +33,7 @@ module RunApi
       end
 
       def validate_cover_audio!(params, resource)
-        require_param!(resource, params, :upload_url)
-        require_param!(resource, params, :model)
-        validate_music_prompt_shape!(params, resource)
-        validate_optional!(resource, params, :vocal_mode, Types::VOCAL_MODES)
-        validate_optional!(resource, params, :model, Types::MODELS)
-        validate_optional!(resource, params, :vocal_gender, Types::VOCAL_GENDERS)
-        validate_optional!(resource, params, :persona_type, Types::PERSONA_TYPES)
+        resource.send(:validate_contract!, CONTRACT["cover-audio"], params)
       end
 
       def validate_add_instrumental!(params, resource)
@@ -62,8 +49,7 @@ module RunApi
       end
 
       def validate_separate_audio_stems!(params, resource)
-        require_all!(resource, params, :task_id, :audio_id)
-        validate_optional!(resource, params, :type, Types::SEPARATE_AUDIO_STEMS_TYPES)
+        resource.send(:validate_contract!, CONTRACT["separate-audio-stems"], params)
       end
 
       def validate_generate_midi!(params, resource)
@@ -87,10 +73,18 @@ module RunApi
       end
 
       def validate_replace_section!(params, resource)
-        require_all!(resource, params, :task_id, :audio_id, :lyrics, :tags, :title, :infill_start_time, :infill_end_time)
-        if param(resource, params, :infill_end_time).to_f <= param(resource, params, :infill_start_time).to_f
+        resource.send(:validate_contract!, CONTRACT["replace-section"], params)
+        validate_replace_section_source!(params, resource)
+        start_time = replace_section_time!(params, resource, :infill_start_time)
+        end_time = replace_section_time!(params, resource, :infill_end_time)
+        if end_time <= start_time
           raise Core::ValidationError, "infill_end_time must be greater than infill_start_time"
         end
+
+        duration = end_time - start_time
+        return if duration.between?(6, 60)
+
+        raise Core::ValidationError, "replacement duration must be between 6 and 60 seconds"
       end
 
       def validate_create_mashup!(params, resource)
@@ -98,12 +92,7 @@ module RunApi
         unless upload_url_list.is_a?(Array) && upload_url_list.size == 2
           raise Core::ValidationError, "upload_url_list must contain exactly 2 URLs"
         end
-        require_param!(resource, params, :model)
-        validate_music_prompt_shape!(params, resource)
-        validate_optional!(resource, params, :vocal_mode, Types::VOCAL_MODES)
-        validate_optional!(resource, params, :model, Types::MODELS)
-        validate_optional!(resource, params, :vocal_gender, Types::VOCAL_GENDERS)
-        validate_optional!(resource, params, :persona_type, Types::PERSONA_TYPES)
+        resource.send(:validate_contract!, CONTRACT["create-mashup"], params)
       end
 
       def validate_text_to_sound!(params, resource)
@@ -148,28 +137,6 @@ module RunApi
         require_param!(resource, params, :description)
       end
 
-      def validate_music_prompt_shape!(params, resource)
-        mode = param(resource, params, :vocal_mode).to_s
-        has_prompt = truthy_presence?(param(resource, params, :prompt))
-        has_lyrics = truthy_presence?(param(resource, params, :lyrics))
-        has_style = truthy_presence?(param(resource, params, :style))
-        has_title = truthy_presence?(param(resource, params, :title))
-
-        valid_shape = case mode
-        when "auto_lyrics"
-          has_prompt && !has_lyrics && !has_style && !has_title
-        when "exact_lyrics"
-          !has_prompt && has_lyrics && has_style && has_title
-        when "instrumental"
-          !has_prompt && !has_lyrics && has_style && has_title
-        else
-          false
-        end
-        return if valid_shape
-
-        raise Core::ValidationError, MUSIC_PROMPT_SHAPE_ERROR
-      end
-
       def validate_extend_music_prompt_shape!(params, resource)
         return unless truthy_presence?(param(resource, params, :lyrics))
 
@@ -187,6 +154,30 @@ module RunApi
         raise Core::ValidationError, "lyrics can only be used when extending uploaded audio with custom parameters"
       end
 
+      def validate_replace_section_source!(params, resource)
+        has_existing_source = %i[task_id audio_id].any? { |key| truthy_presence?(param(resource, params, key)) }
+        has_uploaded_source = %i[upload_url model].any? { |key| truthy_presence?(param(resource, params, key)) }
+
+        if has_existing_source && has_uploaded_source
+          raise Core::ValidationError, "task_id/audio_id cannot be combined with upload_url/model"
+        end
+
+        if has_existing_source
+          require_all!(resource, params, :task_id, :audio_id)
+        elsif has_uploaded_source
+          require_all!(resource, params, :upload_url, :model)
+        else
+          raise Core::ValidationError, "task_id and audio_id, or upload_url and model are required"
+        end
+      end
+
+      def replace_section_time!(params, resource, key)
+        value = param(resource, params, key)
+        return value.to_f if value.is_a?(Numeric)
+
+        raise Core::ValidationError, "#{key} must be a number"
+      end
+
       def require_all!(resource, params, *keys)
         keys.each { |key| require_param!(resource, params, key) }
       end

data/lib/runapi/suno.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "suno/types"
+require_relative "suno/contract_gen"
 require_relative "suno/validators"
 require_relative "suno/resources/text_to_music"
 require_relative "suno/resources/extend_music"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-suno
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.9
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.2.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
-description: The suno ai api Ruby SDK is the language-specific package for Suno on
-  RunAPI. Use this suno ai api package for song generation, lyrics, vocal, extension,
-  and audio transformation flows when your application needs JSON request bodies,
-  task status lookup, and consistent RunAPI errors in Ruby.
+        version: 0.2.13
+description: The Suno Ruby SDK is the language-specific package for Suno on RunAPI.
+  Use this package for song generation, lyrics, vocals, extension, and audio transformation
+  workflows when your application needs request bodies, task status lookup, and consistent
+  RunAPI errors in Ruby.
 email:
 - contact@runapi.ai
 executables: []
@@ -39,6 +39,7 @@ files:
 - lib/runapi-suno.rb
 - lib/runapi/suno.rb
 - lib/runapi/suno/client.rb
+- lib/runapi/suno/contract_gen.rb
 - lib/runapi/suno/resources/add_instrumental.rb
 - lib/runapi/suno/resources/add_vocals.rb
 - lib/runapi/suno/resources/boost_style.rb
@@ -66,9 +67,11 @@ homepage: https://runapi.ai/models/suno
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: suno
   homepage_uri: https://runapi.ai/models/suno
   documentation_uri: https://github.com/runapi-ai/suno-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/suno-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/suno-sdk/issues
   changelog_uri: https://github.com/runapi-ai/suno-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -86,5 +89,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Suno AI API Ruby SDK for RunAPI
+summary: Suno API Ruby SDK for RunAPI
 test_files: []