ci: regenerated with OpenAPI Doc 0.0.3, Speakeasy CLI 1.148.0

internal/sdk/log.go

@@ -88,18 +88,51 @@ func (s *Log) LogLine(ctx context.Context, request operations.LogLineRequest) (*
 }
 
 // LogMultiLine - Logging a multi-line message
-// This endpoint will write multiple lines to the main Plex Media Server log in a single request. It takes a set of query strings as would normally sent to the above GET endpoint as a linefeed-separated block of POST data. The parameters for each query string match as above.
-func (s *Log) LogMultiLine(ctx context.Context) (*operations.LogMultiLineResponse, error) {
+// This endpoint allows for the batch addition of log entries to the main Plex Media Server log.
+// It accepts a text/plain request body, where each line represents a distinct log entry.
+// Each log entry consists of URL-encoded key-value pairs, specifying log attributes such as 'level', 'message', and 'source'.
+//
+// Log entries are separated by a newline character (`\n`).
+// Each entry's parameters should be URL-encoded to ensure accurate parsing and handling of special characters.
+// This method is efficient for logging multiple entries in a single API call, reducing the overhead of multiple individual requests.
+//
+// The 'level' parameter specifies the log entry's severity or importance, with the following integer values:
+// - `0`: Error - Critical issues that require immediate attention.
+// - `1`: Warning - Important events that are not critical but may indicate potential issues.
+// - `2`: Info - General informational messages about system operation.
+// - `3`: Debug - Detailed information useful for debugging purposes.
+// - `4`: Verbose - Highly detailed diagnostic information for in-depth analysis.
+//
+// The 'message' parameter contains the log text, and 'source' identifies the log message's origin (e.g., an application name or module).
+//
+// Example of a single log entry format:
+// `level=4&message=Sample%20log%20entry&source=applicationName`
+//
+// Ensure each parameter is properly URL-encoded to avoid interpretation issues.
+func (s *Log) LogMultiLine(ctx context.Context, request string) (*operations.LogMultiLineResponse, error) {
 	baseURL := utils.ReplaceParameters(s.sdkConfiguration.GetServerDetails())
 	url := strings.TrimSuffix(baseURL, "/") + "/log"
 
-	req, err := http.NewRequestWithContext(ctx, "POST", url, nil)
+	bodyReader, reqContentType, err := utils.SerializeRequestBody(ctx, request, false, false, "Request", "string", `request:"mediaType=text/plain"`)
+	if err != nil {
+		return nil, fmt.Errorf("error serializing request body: %w", err)
+	}
+	if bodyReader == nil {
+		return nil, fmt.Errorf("request body is required")
+	}
+
+	debugBody := bytes.NewBuffer([]byte{})
+	debugReader := io.TeeReader(bodyReader, debugBody)
+
+	req, err := http.NewRequestWithContext(ctx, "POST", url, debugReader)
 	if err != nil {
 		return nil, fmt.Errorf("error creating request: %w", err)
 	}
 	req.Header.Set("Accept", "application/json")
 	req.Header.Set("user-agent", s.sdkConfiguration.UserAgent)
 
+	req.Header.Set("Content-Type", reqContentType)
+
 	client := s.sdkConfiguration.SecurityClient
 
 	httpRes, err := client.Do(req)
@@ -114,6 +147,7 @@ func (s *Log) LogMultiLine(ctx context.Context) (*operations.LogMultiLineRespons
 	if err != nil {
 		return nil, fmt.Errorf("error reading response body: %w", err)
 	}
+	httpRes.Request.Body = io.NopCloser(debugBody)
 	httpRes.Body.Close()
 	httpRes.Body = io.NopCloser(bytes.NewBuffer(rawBody))