typecast-ruby 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f65c6725ca10d449b9ba688231a8ad96a7042197efe9fdba188b84a55fa1d232
-  data.tar.gz: 9995e18d6b6364c9e9906216d643759ab0570b0867228cb49951a0e7259ccb2e
+  metadata.gz: 6f13e3b3f4318a0a02d9e6f4a0ae42aedbd260a422dbb8cdd1cac83954b00c4c
+  data.tar.gz: 47db73ac6a78270f0bf13c3c04569fe4ff471211b3cd579cc33b85e15c468816
 SHA512:
-  metadata.gz: e724bac05758d13d390cb1865eb522c57b55cdd6ae976d778d28643b06db35f390e3151040a4f611138977a13d6f07448ec35f39cb86f13ce7376915b2820c50
-  data.tar.gz: 75001ca132eed41352314a431fc34d184f5d3f8c931f3cbce6b5809ca9f90214da108c6f97c7bf48d048744a325ee15783c2bc9d75faef053a74c3fcf93c0dc2
+  metadata.gz: ab36553b84e5ec6ee14c7988d2970945e170252f142a6d6e5d8853b2caf171ea87d5c93aa7124cab0b54d9bdcfb6ce3887dd2d9f4ea5e57ff65d882cb45985f8
+  data.tar.gz: 193f865fdfd38e7dbe2d5faba6c1288bea4f0665516ea559e15c1079b962726a57214d67589059528699b7f23069fffab1527750e788436423b3d1b51310d37b

data/lib/typecast/client.rb

@@ -16,12 +16,13 @@ module Typecast
 
     attr_reader :api_key, :base_url
 
-    def initialize(api_key: ENV["TYPECAST_API_KEY"], base_url: ENV["TYPECAST_API_HOST"] || DEFAULT_BASE_URL, open_timeout: 10, read_timeout: 30)
+    def initialize(api_key: ENV["TYPECAST_API_KEY"], base_url: ENV["TYPECAST_API_HOST"] || DEFAULT_BASE_URL, open_timeout: 10, read_timeout: 30, source: nil, generated_by: nil)
       @api_key = api_key.to_s.strip
       @base_url = normalize_base_url(base_url)
       validate_api_key!
       @open_timeout = open_timeout
       @read_timeout = read_timeout
+      @attribution = attribution_suffix(source, generated_by)
     end
 
     def text_to_speech(request)
@@ -29,14 +30,24 @@ module Typecast
       Models::TTSResponse.new(
         audio_data: response.body,
         duration: response["X-Audio-Duration"].to_f,
-        format: response["Content-Type"].to_s.include?("mp3") || response["Content-Type"].to_s.include?("mpeg") ? Models::AUDIO_MP3 : Models::AUDIO_WAV
+        format: response["Content-Type"].to_s.downcase.include?("mp3") || response["Content-Type"].to_s.downcase.include?("mpeg") ? Models::AUDIO_MP3 : Models::AUDIO_WAV
       )
     end
 
     def compose_speech
-      SpeechComposer.new(method(:text_to_speech))
+      SpeechComposer.new(method(:compose_text_to_speech))
     end
 
+    def compose_text_to_speech(segments)
+      response = request_json(:post, "/v1/text-to-speech/compose", segments: segments)
+      Models::TTSResponse.new(
+        audio_data: response.body,
+        duration: response["X-Audio-Duration"].to_f,
+        format: response["Content-Type"].to_s.downcase.include?("mp3") || response["Content-Type"].to_s.downcase.include?("mpeg") ? Models::AUDIO_MP3 : Models::AUDIO_WAV
+      )
+    end
+    private :compose_text_to_speech
+
     # Browse available API voices at https://typecast.ai/developers/api/voices.
     def generate_to_file(path, text:, voice_id:, model: Models::TTS_MODEL_V30, language: nil, prompt: nil, output: nil, seed: nil)
       request = Models::TTSRequest.new(
@@ -180,7 +191,16 @@ module Typecast
       base = default_base_url? ? "default" : "custom"
       timeout = @read_timeout == 30 ? "default" : "#{@read_timeout}s"
       "typecast-ruby/#{VERSION} Ruby/#{RUBY_VERSION} net-http " \
-        "(base=#{base}; timeout=#{timeout}; os=#{os_name}; arch=#{arch_name}; sdk_env=ruby; platform=server)"
+        "(base=#{base}; timeout=#{timeout}; os=#{os_name}; arch=#{arch_name}; sdk_env=ruby; platform=server)#{@attribution}"
+    end
+
+    def attribution_suffix(source, generated_by)
+      return "" if source.nil? && generated_by.nil?
+      unless %w[llms skill].include?(source) && generated_by&.match?(/\A[a-z0-9][a-z0-9._-]{0,31}\z/)
+        raise ArgumentError, "source (llms or skill) and generated_by must be valid and provided together"
+      end
+
+      " typecast-integration/1 (source=#{source}; generated_by=#{generated_by})"
     end
 
     def os_name

data/lib/typecast/composer.rb

@@ -1,5 +1,3 @@
-require "stringio"
-
 require "typecast/models"
 
 module Typecast
@@ -13,10 +11,12 @@ module Typecast
     last_index = 0
     text.to_s.scan(PAUSE_TOKEN) do |match|
       match_data = Regexp.last_match
+      seconds = match[0].to_f
+      next unless seconds.finite? && seconds.positive?
       if match_data.begin(0) > last_index
         parts << TextPart.new(kind: "text", text: text[last_index...match_data.begin(0)])
       end
-      parts << PausePart.new(kind: "pause", seconds: match[0].to_f)
+      parts << PausePart.new(kind: "pause", seconds: seconds)
       last_index = match_data.end(0)
     end
     if last_index < text.length
@@ -26,8 +26,8 @@ module Typecast
   end
 
   class SpeechComposer
-    def initialize(text_to_speech)
-      @text_to_speech = text_to_speech
+    def initialize(compose)
+      @compose = compose
       @defaults = {}
       @parts = []
     end
@@ -78,39 +78,22 @@ module Typecast
         raise ArgumentError, "at least one speech segment is required"
       end
 
-      output_format = @defaults.dig(:output, :audio_format) || Models::AUDIO_WAV
+      formats = plan.each_with_object([]) do |part, values|
+        format = part.is_a?(Hash) && part[:kind] == "speech" ? part.dig(:settings, :output, :audio_format) : nil
+        values << format if format
+      end.uniq
+      raise ArgumentError, "composed speech segments must use one audio format" if formats.length > 1
+
+      output_format = formats.first || Models::AUDIO_WAV
       unless [Models::AUDIO_WAV, Models::AUDIO_MP3].include?(output_format)
         raise ArgumentError, "unsupported composed speech output format: #{output_format}"
       end
 
-      wav_spec = nil
-      output_samples = []
-      plan.each do |part|
-        if part.is_a?(PausePart)
-          raise ArgumentError, "pause cannot be the first composed part" if wav_spec.nil?
-
-          output_samples.concat(Array.new(seconds_to_samples(part.seconds, wav_spec[:sample_rate]), 0))
-          next
-        end
-
-        response = @text_to_speech.call(request_from_settings(part[:text], part[:settings]))
-        wav = parse_wav(response.audio_data)
-        if wav_spec && wav[:spec] != wav_spec
-          raise ArgumentError, "all composed WAV segments must use the same PCM format"
-        end
-
-        wav_spec = wav[:spec]
-        output_samples.concat(trim_silence(wav[:samples]))
+      segments = plan.map do |part|
+        part.is_a?(PausePart) ? { type: "pause", duration_seconds: part.seconds } :
+          { type: "tts", **request_from_settings(part[:text], part[:settings], output_format).to_h }
       end
-
-      wav_data = encode_wav(output_samples, wav_spec)
-      raise ArgumentError, "ffmpeg is required to encode composed speech as mp3" if output_format == Models::AUDIO_MP3
-
-      Models::TTSResponse.new(
-        audio_data: wav_data,
-        duration: output_samples.length.to_f / wav_spec[:sample_rate],
-        format: Models::AUDIO_WAV
-      )
+      @compose.call(segments)
     end
 
     private
@@ -169,8 +152,8 @@ module Typecast
       output
     end
 
-    def request_from_settings(text, settings)
-      output = merge_output(settings[:output], audio_format: Models::AUDIO_WAV)
+    def request_from_settings(text, settings, output_format)
+      output = merge_output(settings[:output], audio_format: output_format)
       Models::TTSRequest.new(
         voice_id: settings[:voice_id],
         text: text,
@@ -182,68 +165,5 @@ module Typecast
       )
     end
 
-    def parse_wav(data)
-      io = StringIO.new(data)
-      raise ArgumentError, "unsupported WAV data" unless io.read(4) == "RIFF"
-
-      io.read(4)
-      raise ArgumentError, "unsupported WAV data" unless io.read(4) == "WAVE"
-
-      spec = nil
-      samples = nil
-      until io.eof?
-        chunk_id = io.read(4)
-        break if chunk_id.nil? || chunk_id.bytesize < 4
-
-        chunk_size_bytes = io.read(4)
-        raise ArgumentError, "unsupported WAV data" if chunk_size_bytes.nil? || chunk_size_bytes.bytesize < 4
-
-        chunk_size = chunk_size_bytes.unpack1("V")
-        chunk_data = io.read(chunk_size)
-        io.read(1) if chunk_size.odd?
-        raise ArgumentError, "unsupported WAV data" if chunk_data.nil? || chunk_data.bytesize < chunk_size
-
-        case chunk_id
-        when "fmt "
-          audio_format, channels, sample_rate, _byte_rate, _block_align, bits_per_sample = chunk_data.unpack("vvVVvv")
-          if audio_format != 1 || channels != 1 || bits_per_sample != 16
-            raise ArgumentError, "only mono 16-bit PCM WAV is supported for composed speech"
-          end
-          spec = { sample_rate: sample_rate, channels: channels, bits_per_sample: bits_per_sample }
-        when "data"
-          samples = chunk_data.unpack("s<*")
-        end
-      end
-
-      raise ArgumentError, "unsupported WAV data" if spec.nil? || samples.nil?
-
-      { spec: spec, samples: samples }
-    end
-
-    def encode_wav(samples, spec)
-      payload = samples.pack("s<*")
-      [
-        "RIFF",
-        [36 + payload.bytesize].pack("V"),
-        "WAVE",
-        "fmt ",
-        [16, 1, spec[:channels], spec[:sample_rate], spec[:sample_rate] * spec[:channels] * 2, spec[:channels] * 2, spec[:bits_per_sample]].pack("VvvVVvv"),
-        "data",
-        [payload.bytesize].pack("V"),
-        payload
-      ].join
-    end
-
-    def trim_silence(samples)
-      start_index = 0
-      end_index = samples.length
-      start_index += 1 while start_index < end_index && samples[start_index].abs <= 0
-      end_index -= 1 while end_index > start_index && samples[end_index - 1].abs <= 0
-      samples[start_index...end_index] || []
-    end
-
-    def seconds_to_samples(seconds, sample_rate)
-      (seconds * sample_rate).round
-    end
   end
 end

data/lib/typecast/version.rb

@@ -1,3 +1,3 @@
 module Typecast
-  VERSION = "0.1.5"
+  VERSION = "0.1.8"
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: typecast-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Neosapience
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -60,7 +73,6 @@ homepage: https://github.com/neosapience/typecast-sdk/tree/main/typecast-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -75,8 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Official Ruby SDK for the Typecast Text-to-Speech API
 test_files: []