mangoapps-ex-sdk-ruby 0.15.2

data/lib/mangoapps/modules/recognitions/award_categories.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module AwardCategories
+        def award_categories(page: 1, limit: 20, params: {})
+          params = params.merge(page: page, limit: limit)
+          get("v2/recognitions/get_award_categories.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/core_value_tags.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module CoreValueTags
+        def core_value_tags(params = {})
+          get("v2/recognitions/get_core_value_tags.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/get_award_feeds.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module GetAwardFeeds
+        def get_award_feeds(page: 1, limit: 20, params: {})
+          params = params.merge(page: page, limit: limit)
+          get("v2/recognitions/get_award_feeds.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/get_awards_list.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module GetAwardsList
+        def get_awards_list(category_id, page: 1, limit: 20, params: {})
+          params = params.merge(category_id: category_id, page: page, limit: limit)
+          get("v2/recognitions/get_awards_list.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/get_profile_awards.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module GetProfileAwards
+        def get_profile_awards(params = {})
+          get("v2/recognitions/get_profile_awards.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/get_team_awards.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module GetTeamAwards
+        def get_team_awards(params = {})
+          get("v2/recognitions/get_team_awards.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/gift_cards.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module GiftCards
+        def gift_cards(params = {})
+          get("v2/recognitions/gift_cards.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions/leaderboard_info.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Recognitions
+      module LeaderboardInfo
+        def leaderboard_info(params = {})
+          get("v2/recognitions/get_leaderboard_info.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/recognitions.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "recognitions/award_categories"
+require_relative "recognitions/core_value_tags"
+require_relative "recognitions/leaderboard_info"
+require_relative "recognitions/gift_cards"
+require_relative "recognitions/get_awards_list"
+require_relative "recognitions/get_profile_awards"
+require_relative "recognitions/get_team_awards"
+require_relative "recognitions/get_award_feeds"
+
+module MangoApps
+  class Client
+    module Recognitions
+      # Include all recognitions sub-modules
+      include MangoApps::Client::Recognitions::AwardCategories
+      include MangoApps::Client::Recognitions::CoreValueTags
+      include MangoApps::Client::Recognitions::LeaderboardInfo
+      include MangoApps::Client::Recognitions::GiftCards
+      include MangoApps::Client::Recognitions::GetAwardsList
+      include MangoApps::Client::Recognitions::GetProfileAwards
+      include MangoApps::Client::Recognitions::GetTeamAwards
+      include MangoApps::Client::Recognitions::GetAwardFeeds
+    end
+  end
+end

data/lib/mangoapps/modules/tasks/get_task_details.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Tasks
+      module GetTaskDetails
+        def get_task_details(task_id, params = {})
+          get("tasks/#{task_id}.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/tasks/get_tasks.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Tasks
+      module GetTasks
+        def get_tasks(filter: "Pending_Tasks", page: 1, limit: 5, params: {})
+          params = params.merge(filter: filter, page: page, limit: limit)
+          get("tasks/new_index.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/tasks.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "tasks/get_tasks"
+require_relative "tasks/get_task_details"
+
+module MangoApps
+  class Client
+    module Tasks
+      # Include all tasks sub-modules
+      include MangoApps::Client::Tasks::GetTasks
+      include MangoApps::Client::Tasks::GetTaskDetails
+    end
+  end
+end

data/lib/mangoapps/modules/trackers/get_trackers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Trackers
+      module GetTrackers
+        def get_trackers(page: 1, limit: 20, params: {})
+          params = params.merge(page: page, limit: limit)
+          get("v2/trackers.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/trackers.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "trackers/get_trackers"
+
+module MangoApps
+  class Client
+    module Trackers
+      # Include all trackers sub-modules
+      include MangoApps::Client::Trackers::GetTrackers
+    end
+  end
+end

data/lib/mangoapps/modules/users.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Users
+      def me(params = {})
+        get("v2/me.json", params: params)
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/wikis/get_wiki_details.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Wikis
+      module GetWikiDetails
+        def get_wiki_details(wiki_id, params = {})
+          get("v2/wikis/#{wiki_id}.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/wikis/get_wikis.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MangoApps
+  class Client
+    module Wikis
+      module GetWikis
+        def get_wikis(mode: "my", page: 1, limit: 20, params: {})
+          params = params.merge(mode: mode, page: page, limit: limit)
+          get("v2/wikis.json", params: params)
+        end
+      end
+    end
+  end
+end

data/lib/mangoapps/modules/wikis.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "wikis/get_wikis"
+require_relative "wikis/get_wiki_details"
+
+module MangoApps
+  class Client
+    module Wikis
+      # Include all wikis sub-modules
+      include MangoApps::Client::Wikis::GetWikis
+      include MangoApps::Client::Wikis::GetWikiDetails
+    end
+  end
+end

data/lib/mangoapps/oauth.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require "oauth2"
+require "json"
+require "net/http"
+require "uri"
+
+module MangoApps
+  class OAuth
+    Discovery = Struct.new(:issuer, :authorization_endpoint, :token_endpoint, :userinfo_endpoint,
+                           :end_session_endpoint, :jwks_uri)
+
+    def initialize(config)
+      @config = config
+    end
+
+    # Discover OIDC endpoints from well-known config
+    def discover!
+      # Ensure we always use HTTPS for discovery
+      base_url = @config.base_url
+      base_url = base_url.gsub(/^http:/, 'https:') unless base_url.start_with?('https:')
+      url = URI.parse("#{base_url}/.well-known/openid-configuration")
+
+      begin
+        # Use proper HTTPS handling for discovery
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = (url.scheme == 'https')
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER if http.use_ssl?
+        
+        request = Net::HTTP::Get.new(url)
+        res = http.request(request)
+        raise MangoApps::DiscoveryError, "OIDC discovery failed: #{res.code}" unless res.is_a?(Net::HTTPSuccess)
+
+        data = JSON.parse(res.body)
+        validate_discovery_data(data)
+
+        @discovery = Discovery.new(
+          data["issuer"],
+          data["authorization_endpoint"],
+          data["token_endpoint"],
+          data["userinfo_endpoint"],
+          data["end_session_endpoint"],
+          data["jwks_uri"]
+        )
+      rescue JSON::ParserError => e
+        raise MangoApps::DiscoveryError, "Invalid JSON response from discovery endpoint: #{e.message}"
+      rescue Net::ReadTimeout, Net::OpenTimeout, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Timeout::Error => e
+        raise MangoApps::DiscoveryError, "Failed to connect to discovery endpoint: #{e.message}"
+      rescue OpenSSL::SSL::SSLError => e
+        raise MangoApps::DiscoveryError, "SSL connection failed for discovery endpoint: #{e.message}"
+      end
+    end
+
+    def discovery
+      @discovery || discover!
+    end
+
+    # OAuth2::Client using discovered endpoints
+    def client
+      @client ||= ::OAuth2::Client.new(
+        @config.client_id,
+        @config.client_secret,
+        site: @config.base_url,
+        authorize_url: discovery.authorization_endpoint,
+        token_url: discovery.token_endpoint
+      )
+    end
+
+    # Build an auth URL for browser-based login (PKCE optional)
+    def authorization_url(state:, code_challenge: nil, code_challenge_method: "S256", extra_params: {})
+      params = {
+        redirect_uri: @config.redirect_uri,
+        scope: @config.scope,
+        state: state,
+        response_type: "code",
+      }.merge(extra_params)
+
+      if code_challenge
+        params[:code_challenge] = code_challenge
+        params[:code_challenge_method] = code_challenge_method
+      end
+
+      client.auth_code.authorize_url(params)
+    end
+
+    # Exchange code for tokens (PKCE verifier optional)
+    def get_token(authorization_code:, code_verifier: nil)
+      token = client.auth_code.get_token(
+        authorization_code,
+        redirect_uri: @config.redirect_uri,
+        headers: { "Content-Type" => "application/x-www-form-urlencoded" },
+        code_verifier: code_verifier
+      )
+      persist(token)
+      token
+    rescue OAuth2::Error => e
+      raise MangoApps::TokenExchangeError, "Token exchange failed: #{e.message}"
+    end
+
+    def refresh!(token)
+      raise MangoApps::TokenExpiredError, "No refresh_token available" unless token&.refresh_token
+
+      begin
+        new_token = token.refresh!
+        persist(new_token)
+        new_token
+      rescue OAuth2::Error => e
+        raise MangoApps::TokenExpiredError, "Token refresh failed: #{e.message}"
+      end
+    end
+
+    def load_token
+      @config.token_store&.load
+    end
+
+    # Get user info from OAuth userinfo endpoint
+    def get_userinfo(access_token)
+      raise MangoApps::TokenExpiredError, "No access token provided" unless access_token
+
+      userinfo_url = discovery.userinfo_endpoint
+      # Ensure userinfo endpoint uses HTTPS
+      userinfo_url = userinfo_url.gsub(/^http:/, 'https:') unless userinfo_url.start_with?('https:')
+      url = URI.parse(userinfo_url)
+      
+      begin
+        # Ensure we use the correct port for HTTPS
+        port = url.port || (url.scheme == 'https' ? 443 : 80)
+        http = Net::HTTP.new(url.host, port)
+        http.use_ssl = (url.scheme == 'https')
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER if http.use_ssl?
+        
+        request = Net::HTTP::Get.new(url)
+        request['Authorization'] = "Bearer #{access_token}"
+        request['Accept'] = 'application/json'
+        
+        response = http.request(request)
+        
+        # Handle redirects (301, 302)
+        if response.is_a?(Net::HTTPRedirection)
+          redirect_url = response['location']
+          if redirect_url
+            # Follow the redirect with HTTPS
+            redirect_uri = URI.parse(redirect_url)
+            redirect_uri.scheme = 'https' if redirect_uri.scheme == 'http'
+            
+            http = Net::HTTP.new(redirect_uri.host, redirect_uri.port)
+            http.use_ssl = (redirect_uri.scheme == 'https')
+            http.verify_mode = OpenSSL::SSL::VERIFY_PEER if http.use_ssl?
+            
+            request = Net::HTTP::Get.new(redirect_uri)
+            request['Authorization'] = "Bearer #{access_token}"
+            request['Accept'] = 'application/json'
+            
+            response = http.request(request)
+          end
+        end
+        
+        unless response.is_a?(Net::HTTPSuccess)
+          raise MangoApps::APIError, "Userinfo request failed: #{response.code} #{response.message}"
+        end
+        
+        JSON.parse(response.body)
+      rescue JSON::ParserError => e
+        raise MangoApps::APIError, "Invalid JSON response from userinfo endpoint: #{e.message}"
+      rescue Net::ReadTimeout, Net::OpenTimeout, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Timeout::Error => e
+        raise MangoApps::APIError, "Failed to connect to userinfo endpoint: #{e.message}"
+      rescue OpenSSL::SSL::SSLError => e
+        raise MangoApps::APIError, "SSL connection failed for userinfo endpoint: #{e.message}"
+      end
+    end
+
+    private
+
+    def validate_discovery_data(data)
+      required_fields = %w[issuer authorization_endpoint token_endpoint]
+      missing_fields = required_fields - data.keys
+
+      if missing_fields.any?
+        raise MangoApps::DiscoveryError, "Missing required fields in discovery response: #{missing_fields.join(', ')}"
+      end
+    end
+
+    def persist(token)
+      @config.token_store&.save(token.to_hash)
+    end
+  end
+end

data/lib/mangoapps/response.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module MangoApps
+  # Response wrapper that provides clean dot notation access to MangoApps API responses
+  # Abstracts away the ms_response wrapper and provides intuitive access patterns
+  class Response
+    include Enumerable
+
+    def initialize(data)
+      @data = data
+      @ms_response = data["ms_response"] || data
+    end
+
+    # Delegate to ms_response for cleaner access
+    def method_missing(method_name, *args, &block)
+      if @ms_response.respond_to?(method_name)
+        @ms_response.public_send(method_name, *args, &block)
+      elsif @ms_response.is_a?(Hash) && @ms_response.key?(method_name.to_s)
+        value = @ms_response[method_name.to_s]
+        wrap_value(value)
+      elsif @ms_response.is_a?(Hash) && @ms_response.key?(method_name.to_sym)
+        value = @ms_response[method_name.to_sym]
+        wrap_value(value)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @ms_response.respond_to?(method_name, include_private) ||
+        (@ms_response.is_a?(Hash) && 
+         (@ms_response.key?(method_name.to_s) || @ms_response.key?(method_name.to_sym))) ||
+        super
+    end
+
+    # Array access for hash-like behavior
+    def [](key)
+      value = @ms_response[key]
+      wrap_value(value)
+    end
+
+    # Hash-like key access
+    def key?(key)
+      @ms_response.key?(key)
+    end
+
+    def keys
+      @ms_response.keys
+    end
+
+    def values
+      @ms_response.values.map { |v| wrap_value(v) }
+    end
+
+    # Enumerable support
+    def each(&block)
+      @ms_response.each(&block)
+    end
+
+    # Convert back to hash if needed
+    def to_h
+      @ms_response
+    end
+
+    def to_hash
+      @ms_response
+    end
+
+    # Pretty inspection
+    def inspect
+      "#<MangoApps::Response:#{object_id} @data=#{@ms_response.inspect}>"
+    end
+
+    # Access to raw data if needed
+    def raw_data
+      @data
+    end
+
+    private
+
+    def wrap_value(value)
+      case value
+      when Hash
+        Response.new(value)
+      when Array
+        value.map { |item| wrap_value(item) }
+      else
+        value
+      end
+    end
+  end
+end

data/lib/mangoapps/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MangoApps
+  VERSION = "0.15.2"
+end

data/lib/mangoapps.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "mangoapps/version"
+require_relative "mangoapps/errors"
+require_relative "mangoapps/config"
+require_relative "mangoapps/oauth"
+require_relative "mangoapps/response"
+require_relative "mangoapps/client"
+require_relative "mangoapps/modules/learn"
+require_relative "mangoapps/modules/users"
+require_relative "mangoapps/modules/recognitions"
+require_relative "mangoapps/modules/notifications"
+require_relative "mangoapps/modules/feeds"
+require_relative "mangoapps/modules/posts"
+require_relative "mangoapps/modules/libraries"
+require_relative "mangoapps/modules/trackers"
+require_relative "mangoapps/modules/attachments"
+require_relative "mangoapps/modules/tasks"
+require_relative "mangoapps/modules/wikis"
+
+module MangoApps; end
+
+# Mix in the resources
+MangoApps::Client.include(MangoApps::Client::Learn)
+MangoApps::Client.include(MangoApps::Client::Users)
+MangoApps::Client.include(MangoApps::Client::Recognitions)
+MangoApps::Client.include(MangoApps::Client::Notifications)
+MangoApps::Client.include(MangoApps::Client::Feeds)
+MangoApps::Client.include(MangoApps::Client::Posts)
+MangoApps::Client.include(MangoApps::Client::Libraries)
+MangoApps::Client.include(MangoApps::Client::Trackers)
+MangoApps::Client.include(MangoApps::Client::Attachments)
+MangoApps::Client.include(MangoApps::Client::Tasks)
+MangoApps::Client.include(MangoApps::Client::Wikis)