# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. # typed: true # frozen_string_literal: true require 'faraday' require 'faraday/multipart' require 'faraday/retry' require 'sorbet-runtime' require_relative 'sdk_hooks/hooks' require_relative 'utils/retries' module PlexRubySDK extend T::Sig class Media extend T::Sig # API Calls interacting with Plex Media Server Media # sig { params(sdk_config: SDKConfiguration).void } def initialize(sdk_config) @sdk_configuration = sdk_config end sig { params(key: ::Float, timeout_ms: T.nilable(Integer)).returns(::PlexRubySDK::Operations::MarkPlayedResponse) } def mark_played(key, timeout_ms = nil) # mark_played - Mark Media Played # This will mark the provided media key as Played. request = ::PlexRubySDK::Operations::MarkPlayedRequest.new( key: key ) url, params = @sdk_configuration.get_server_details base_url = Utils.template_url(url, params) url = "#{base_url}/:/scrobble" headers = {} query_params = Utils.get_query_params(::PlexRubySDK::Operations::MarkPlayedRequest, request) headers['Accept'] = 'application/json' headers['user-agent'] = @sdk_configuration.user_agent security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil? timeout ||= @sdk_configuration.timeout connection = @sdk_configuration.client hook_ctx = SDKHooks::HookContext.new( base_url: base_url, oauth2_scopes: nil, operation_id: 'markPlayed', security_source: @sdk_configuration.security_source ) error = T.let(nil, T.nilable(StandardError)) r = T.let(nil, T.nilable(Faraday::Response)) begin r = connection.get(url) do |req| req.headers.merge!(headers) req.options.timeout = timeout unless timeout.nil? req.params = query_params Utils.configure_request_security(req, security) @sdk_configuration.hooks.before_request( hook_ctx: SDKHooks::BeforeRequestHookContext.new( hook_ctx: hook_ctx ), request: req ) end rescue StandardError => e error = e ensure if r.nil? || Utils.error_status?(r.status) r = @sdk_configuration.hooks.after_error( error: error, hook_ctx: SDKHooks::AfterErrorHookContext.new( hook_ctx: hook_ctx ), response: r ) else r = @sdk_configuration.hooks.after_success( hook_ctx: SDKHooks::AfterSuccessHookContext.new( hook_ctx: hook_ctx ), response: r ) end if r.nil? raise error if !error.nil? raise 'no response' end end content_type = r.headers.fetch('Content-Type', 'application/octet-stream') res = ::PlexRubySDK::Operations::MarkPlayedResponse.new( status_code: r.status, content_type: content_type, raw_response: r ) if r.status == 200 elsif r.status == 400 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::MarkPlayedBadRequest) res.bad_request = out end elsif r.status == 401 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::MarkPlayedUnauthorized) res.unauthorized = out end end res end sig { params(key: ::Float, timeout_ms: T.nilable(Integer)).returns(::PlexRubySDK::Operations::MarkUnplayedResponse) } def mark_unplayed(key, timeout_ms = nil) # mark_unplayed - Mark Media Unplayed # This will mark the provided media key as Unplayed. request = ::PlexRubySDK::Operations::MarkUnplayedRequest.new( key: key ) url, params = @sdk_configuration.get_server_details base_url = Utils.template_url(url, params) url = "#{base_url}/:/unscrobble" headers = {} query_params = Utils.get_query_params(::PlexRubySDK::Operations::MarkUnplayedRequest, request) headers['Accept'] = 'application/json' headers['user-agent'] = @sdk_configuration.user_agent security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil? timeout ||= @sdk_configuration.timeout connection = @sdk_configuration.client hook_ctx = SDKHooks::HookContext.new( base_url: base_url, oauth2_scopes: nil, operation_id: 'markUnplayed', security_source: @sdk_configuration.security_source ) error = T.let(nil, T.nilable(StandardError)) r = T.let(nil, T.nilable(Faraday::Response)) begin r = connection.get(url) do |req| req.headers.merge!(headers) req.options.timeout = timeout unless timeout.nil? req.params = query_params Utils.configure_request_security(req, security) @sdk_configuration.hooks.before_request( hook_ctx: SDKHooks::BeforeRequestHookContext.new( hook_ctx: hook_ctx ), request: req ) end rescue StandardError => e error = e ensure if r.nil? || Utils.error_status?(r.status) r = @sdk_configuration.hooks.after_error( error: error, hook_ctx: SDKHooks::AfterErrorHookContext.new( hook_ctx: hook_ctx ), response: r ) else r = @sdk_configuration.hooks.after_success( hook_ctx: SDKHooks::AfterSuccessHookContext.new( hook_ctx: hook_ctx ), response: r ) end if r.nil? raise error if !error.nil? raise 'no response' end end content_type = r.headers.fetch('Content-Type', 'application/octet-stream') res = ::PlexRubySDK::Operations::MarkUnplayedResponse.new( status_code: r.status, content_type: content_type, raw_response: r ) if r.status == 200 elsif r.status == 400 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::MarkUnplayedBadRequest) res.bad_request = out end elsif r.status == 401 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::MarkUnplayedUnauthorized) res.unauthorized = out end end res end sig { params(key: ::String, time: ::Float, state: ::String, timeout_ms: T.nilable(Integer)).returns(::PlexRubySDK::Operations::UpdatePlayProgressResponse) } def update_play_progress(key, time, state, timeout_ms = nil) # update_play_progress - Update Media Play Progress # This API command can be used to update the play progress of a media item. # request = ::PlexRubySDK::Operations::UpdatePlayProgressRequest.new( key: key, time: time, state: state ) url, params = @sdk_configuration.get_server_details base_url = Utils.template_url(url, params) url = "#{base_url}/:/progress" headers = {} query_params = Utils.get_query_params(::PlexRubySDK::Operations::UpdatePlayProgressRequest, request) headers['Accept'] = 'application/json' headers['user-agent'] = @sdk_configuration.user_agent security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil? timeout ||= @sdk_configuration.timeout connection = @sdk_configuration.client hook_ctx = SDKHooks::HookContext.new( base_url: base_url, oauth2_scopes: nil, operation_id: 'updatePlayProgress', security_source: @sdk_configuration.security_source ) error = T.let(nil, T.nilable(StandardError)) r = T.let(nil, T.nilable(Faraday::Response)) begin r = connection.post(url) do |req| req.headers.merge!(headers) req.options.timeout = timeout unless timeout.nil? req.params = query_params Utils.configure_request_security(req, security) @sdk_configuration.hooks.before_request( hook_ctx: SDKHooks::BeforeRequestHookContext.new( hook_ctx: hook_ctx ), request: req ) end rescue StandardError => e error = e ensure if r.nil? || Utils.error_status?(r.status) r = @sdk_configuration.hooks.after_error( error: error, hook_ctx: SDKHooks::AfterErrorHookContext.new( hook_ctx: hook_ctx ), response: r ) else r = @sdk_configuration.hooks.after_success( hook_ctx: SDKHooks::AfterSuccessHookContext.new( hook_ctx: hook_ctx ), response: r ) end if r.nil? raise error if !error.nil? raise 'no response' end end content_type = r.headers.fetch('Content-Type', 'application/octet-stream') res = ::PlexRubySDK::Operations::UpdatePlayProgressResponse.new( status_code: r.status, content_type: content_type, raw_response: r ) if r.status == 200 elsif r.status == 400 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::UpdatePlayProgressBadRequest) res.bad_request = out end elsif r.status == 401 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::UpdatePlayProgressUnauthorized) res.unauthorized = out end end res end sig { params(request: T.nilable(::PlexRubySDK::Operations::GetBannerImageRequest), timeout_ms: T.nilable(Integer)).returns(::PlexRubySDK::Operations::GetBannerImageResponse) } def get_banner_image(request, timeout_ms = nil) # get_banner_image - Get Banner Image # Gets the banner image of the media item url, params = @sdk_configuration.get_server_details base_url = Utils.template_url(url, params) url = Utils.generate_url( ::PlexRubySDK::Operations::GetBannerImageRequest, base_url, '/library/metadata/{ratingKey}/banner', request ) headers = Utils.get_headers(request) query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetBannerImageRequest, request) headers['Accept'] = 'application/json;q=1, image/jpeg;q=0' headers['user-agent'] = @sdk_configuration.user_agent security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil? timeout ||= @sdk_configuration.timeout connection = @sdk_configuration.client hook_ctx = SDKHooks::HookContext.new( base_url: base_url, oauth2_scopes: nil, operation_id: 'get-banner-image', security_source: @sdk_configuration.security_source ) error = T.let(nil, T.nilable(StandardError)) r = T.let(nil, T.nilable(Faraday::Response)) begin r = connection.get(url) do |req| req.headers.merge!(headers) req.options.timeout = timeout unless timeout.nil? req.params = query_params Utils.configure_request_security(req, security) @sdk_configuration.hooks.before_request( hook_ctx: SDKHooks::BeforeRequestHookContext.new( hook_ctx: hook_ctx ), request: req ) end rescue StandardError => e error = e ensure if r.nil? || Utils.error_status?(r.status) r = @sdk_configuration.hooks.after_error( error: error, hook_ctx: SDKHooks::AfterErrorHookContext.new( hook_ctx: hook_ctx ), response: r ) else r = @sdk_configuration.hooks.after_success( hook_ctx: SDKHooks::AfterSuccessHookContext.new( hook_ctx: hook_ctx ), response: r ) end if r.nil? raise error if !error.nil? raise 'no response' end end content_type = r.headers.fetch('Content-Type', 'application/octet-stream') res = ::PlexRubySDK::Operations::GetBannerImageResponse.new( status_code: r.status, content_type: content_type, raw_response: r ) if r.status == 200 res.headers = r.headers res.bytes = r.env.response_body if Utils.match_content_type(content_type, 'image/jpeg') elsif r.status == 400 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::GetBannerImageBadRequest) res.bad_request = out end elsif r.status == 401 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::GetBannerImageUnauthorized) res.unauthorized = out end end res end sig { params(request: T.nilable(::PlexRubySDK::Operations::GetThumbImageRequest), timeout_ms: T.nilable(Integer)).returns(::PlexRubySDK::Operations::GetThumbImageResponse) } def get_thumb_image(request, timeout_ms = nil) # get_thumb_image - Get Thumb Image # Gets the thumbnail image of the media item url, params = @sdk_configuration.get_server_details base_url = Utils.template_url(url, params) url = Utils.generate_url( ::PlexRubySDK::Operations::GetThumbImageRequest, base_url, '/library/metadata/{ratingKey}/thumb', request ) headers = Utils.get_headers(request) query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetThumbImageRequest, request) headers['Accept'] = 'application/json;q=1, image/jpeg;q=0' headers['user-agent'] = @sdk_configuration.user_agent security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil? timeout ||= @sdk_configuration.timeout connection = @sdk_configuration.client hook_ctx = SDKHooks::HookContext.new( base_url: base_url, oauth2_scopes: nil, operation_id: 'get-thumb-image', security_source: @sdk_configuration.security_source ) error = T.let(nil, T.nilable(StandardError)) r = T.let(nil, T.nilable(Faraday::Response)) begin r = connection.get(url) do |req| req.headers.merge!(headers) req.options.timeout = timeout unless timeout.nil? req.params = query_params Utils.configure_request_security(req, security) @sdk_configuration.hooks.before_request( hook_ctx: SDKHooks::BeforeRequestHookContext.new( hook_ctx: hook_ctx ), request: req ) end rescue StandardError => e error = e ensure if r.nil? || Utils.error_status?(r.status) r = @sdk_configuration.hooks.after_error( error: error, hook_ctx: SDKHooks::AfterErrorHookContext.new( hook_ctx: hook_ctx ), response: r ) else r = @sdk_configuration.hooks.after_success( hook_ctx: SDKHooks::AfterSuccessHookContext.new( hook_ctx: hook_ctx ), response: r ) end if r.nil? raise error if !error.nil? raise 'no response' end end content_type = r.headers.fetch('Content-Type', 'application/octet-stream') res = ::PlexRubySDK::Operations::GetThumbImageResponse.new( status_code: r.status, content_type: content_type, raw_response: r ) if r.status == 200 res.headers = r.headers res.bytes = r.env.response_body if Utils.match_content_type(content_type, 'image/jpeg') elsif r.status == 400 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::GetThumbImageBadRequest) res.bad_request = out end elsif r.status == 401 if Utils.match_content_type(content_type, 'application/json') out = Crystalline.unmarshal_json(JSON.parse(r.env.response_body), ::PlexRubySDK::Operations::GetThumbImageUnauthorized) res.unauthorized = out end end res end end end