More changes for extensions.

Author: fnando

DOCUMENTATION.md

@@ -766,10 +766,6 @@ module. Custom engines must implement the `generate` method:
 module ScreenKit
   module TTS
     class CustomEngine < Base
-      # If you're using shell commands, you can include Shell,
-      # which provides helper methods.
-      # extend Shell
-
       # Optional: Define schema path for validation
       def self.schema_path
         File.join(__dir__, "yourschema.json")
@@ -801,20 +797,18 @@ module ScreenKit
         # Write output to output_path
         # Optionally log to log_path
 
-        # Example implementation calling a command:
+        # Example calling a command (provided by ScreenKit::Shell)
         # self.class.run_command "some-command",
         #                        "-o", output_path.sub_ext(".wav"),
         #                        text,
         #                        log_path:
 
-        # Example implementation using an API:
-        # response = Aitch.post(
+        # Example using an API (provided by ScreenKit::HTTP)
+        # response = json_post(
         #   url: "https://api.example.com/tts",
-        #   headers: {
-        #     content_type: "application/json",
-        #     authorization: "Bearer #{api_key}"
-        #   },
-        #   options: {expect: 200}
+        #   headers: {authorization: "Bearer #{api_key}"},
+        #   api_key:,
+        #   log_path:
         # )
       end
     end
@@ -842,6 +836,7 @@ The engine name is camelized (e.g., `custom_engine` → `CustomEngine`,
 
 - [Search Github](https://github.com/topics/screenkit-tts)
 - [Google Text to Speech](https://github.com/fnando/screenkit-tts-google)
+- [Minimax Text to Speech](https://github.com/fnando/screenkit-tts-minimax)
 
 > [!TIP]
 >

lib/screenkit/http.rb

@@ -2,6 +2,13 @@
 
 module ScreenKit
   module HTTP
+    # Sends a POST request.
+    # @param url [String] The request URL.
+    # @param params [Hash] The request parameters.
+    # @param headers [Hash] The request headers.
+    # @param api_key [String] The API key to redact from logs.
+    # @param log_path [String, nil] The path to log the request details.
+    # @return [Aitch::Response] The response.
     def post(url:, params:, headers:, api_key:, log_path: nil)
       if log_path
         File.open(log_path, "w") do |f|
@@ -16,19 +23,30 @@ def post(url:, params:, headers:, api_key:, log_path: nil)
 
       client.post(
         url:,
-        body: params,
+        params:,
         options: {expect: 200},
         headers: headers.merge(user_agent: "ScreenKit/#{ScreenKit::VERSION}")
       )
     ensure
       redact_file(log_path, api_key)
     end
 
+    # Sends a JSON POST request.
+    # @param url [String] The request URL.
+    # @param params [Hash] The request parameters.
+    # @param headers [Hash] The request headers.
+    # @param api_key [String] The API key to redact from logs.
+    # @param log_path [String, nil] The path to log the request details.
+    # @return [Aitch::Response] The response.
     def json_post(headers:, **)
       headers = headers.merge(content_type: "application/json")
       post(headers:, **)
     end
 
+    # Redacts sensitive text from a file.
+    # @param path [String] The file path.
+    # @param text [String] The text to redact.
+    # @return [void]
     def redact_file(path, text)
       return unless path
       return unless File.file?(path)

lib/screenkit/tts/base.rb

@@ -1,12 +1,21 @@
 # frozen_string_literal: true
 
+require "json-schema"
+require "aitch"
+require "logger"
+
 module ScreenKit
   module TTS
     class Base
-      require_relative "../core_ext"
       require_relative "../schema_validator"
+      require_relative "../shell"
+      require_relative "../http"
+      require_relative "../core_ext"
+      require_relative "../version"
 
       extend SchemaValidator
+      extend Shell
+      include HTTP
 
       using CoreExt