mangoapps-ex-sdk-ruby 19.1.1 → 19.1.3

data/lib/mangoapps/client.rb

@@ -38,20 +38,20 @@ module MangoApps
     end
 
     # ---- HTTP Methods ----
-    def get(path, params: {}, headers: {})
-      request(:get, path, params: params, headers: headers)
+    def get(path, params: {}, headers: {}, unique_user_id: nil)
+      request(:get, path, params: params, headers: headers, unique_user_id: unique_user_id)
     end
 
-    def post(path, body: nil, headers: {})
-      request(:post, path, body: body, headers: headers)
+    def post(path, body: nil, headers: {}, unique_user_id: nil)
+      request(:post, path, body: body, headers: headers, unique_user_id: unique_user_id)
     end
 
-    def put(path, body: nil, headers: {})
-      request(:put, path, body: body, headers: headers)
+    def put(path, body: nil, headers: {}, unique_user_id: nil)
+      request(:put, path, body: body, headers: headers, unique_user_id: unique_user_id)
     end
 
-    def delete(path, headers: {})
-      request(:delete, path, headers: headers)
+    def delete(path, headers: {}, unique_user_id: nil)
+      request(:delete, path, headers: headers, unique_user_id: unique_user_id)
     end
 
     # ---- OAuth Helpers ----
@@ -64,12 +64,12 @@ module MangoApps
       )
     end
 
-    def get_userinfo
+    def get_userinfo(unique_user_id: nil)
       case config.authentication_method
       when :internal_api
         # For internal API, we can't use OAuth userinfo endpoint
         # Instead, we'll use the /me endpoint which provides user info
-        response = get("v2/me.json")
+        response = get("v2/me.json", unique_user_id: unique_user_id)
         response.user_profile.minimal_profile
       when :oauth
         raise MangoApps::TokenExpiredError, "No access token available" unless access_token
@@ -105,23 +105,26 @@ module MangoApps
       }
     end
 
-    def request(method, path, params: nil, body: nil, headers: {})
+    def request(method, path, params: nil, body: nil, headers: {}, unique_user_id: nil)
       ensure_authenticated!
 
+      # Build headers with optional unique_user_id
+      request_headers = auth_headers(unique_user_id: unique_user_id).merge(headers)
+
       # Store request details for error reporting
       request_details = {
         method: method.to_s.upcase,
         url: "#{config.api_base}#{path}",
         params: params,
         body: body,
-        headers: auth_headers.merge(headers)
+        headers: request_headers
       }
 
       response = http.run_request(
         method,
         path,
         (body.nil? ? nil : MultiJson.dump(body)),
-        auth_headers.merge(headers)
+        request_headers
       ) do |req|
         req.params.update(params) if params
       end
@@ -131,13 +134,20 @@ module MangoApps
       handle_error_response(response, request_details)
     end
 
-    def auth_headers
+    def auth_headers(unique_user_id: nil)
       case config.authentication_method
       when :internal_api
         headers = {
           "Internal-Api-Key" => config.internal_api_key,
           "Internal-Api-Secret" => config.internal_api_secret
         }
+        # Add Internal-Api-Email-Id header if unique_user_id is provided
+        if unique_user_id
+          headers["Internal-Api-Email-Id"] = unique_user_id
+        elsif config.internal_api_email_id
+          # Fallback to config-level email ID if no unique_user_id provided
+          headers["Internal-Api-Email-Id"] = config.internal_api_email_id
+        end
         headers
       when :oauth
         { "Authorization" => "Bearer #{access_token.token}" }

data/lib/mangoapps/config.rb

@@ -6,11 +6,11 @@ module MangoApps
   class Config
     attr_accessor :domain, :client_id, :client_secret, :redirect_uri, :scope,
                   :token_store, :timeout, :open_timeout, :logger, :access_token, :refresh_token,
-                  :internal_api_key, :internal_api_secret
+                  :internal_api_key, :internal_api_secret, :internal_api_email_id
 
     def initialize(domain: nil, client_id: nil, client_secret: nil, redirect_uri: nil, scope: nil, # rubocop:disable Metrics/ParameterLists
                    token_store: nil, timeout: 30, open_timeout: 10, logger: nil,
-                   internal_api_key: nil, internal_api_secret: nil)
+                   internal_api_key: nil, internal_api_secret: nil, internal_api_email_id: nil)
       # Load environment variables from .env file
       Dotenv.load if File.exist?(".env")
 
@@ -23,6 +23,7 @@ module MangoApps
       @refresh_token = ENV["MANGOAPPS_REFRESH_TOKEN"]
       @internal_api_key = internal_api_key || ENV["MANGOAPPS_INTERNAL_API_KEY"]
       @internal_api_secret = internal_api_secret || ENV["MANGOAPPS_INTERNAL_API_SECRET"]
+      @internal_api_email_id = internal_api_email_id || ENV["MANGOAPPS_INTERNAL_API_EMAIL_ID"]
       @token_store   = token_store
       @timeout       = timeout
       @open_timeout  = open_timeout

data/lib/mangoapps/modules/attachments/get_folder_files.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Attachments
       module GetFolderFiles
-        def get_folder_files(folder_id, include_folders: "Y", params: {})
-          get("folders/#{folder_id}/files.json?include_folders=#{include_folders}", params: params)
+        def get_folder_files(folder_id, include_folders: "Y", params: {}, unique_user_id: nil)
+          get("folders/#{folder_id}/files.json?include_folders=#{include_folders}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/attachments/get_folders.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Attachments
       module GetFolders
-        def get_folders(params: {})
-          get("folders.json", params: params)
+        def get_folders(params: {}, unique_user_id: nil)
+          get("folders.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/feeds/feeds.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Feeds
       module Feeds
-        def get_feeds(offset: 0, limit: 20, all_comments: 'Y', params: {})
-          get("feeds.json?offset=#{offset}&limit=#{limit}&all_comments=#{all_comments}", params: params)
+        def get_feeds(offset: 0, limit: 20, all_comments: 'Y', params: {}, unique_user_id: nil)
+          get("feeds.json?offset=#{offset}&limit=#{limit}&all_comments=#{all_comments}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/learn/course_catalog.rb

@@ -6,8 +6,8 @@ module MangoApps
       module CourseCatalog
         # Get course catalog from MangoApps Learn API
         # GET /api/v2/learn/course_catalog.json
-        def get_course_catalog(page: 1, limit: 20, params: {})
-          get("v2/learn/course_catalog.json?page=#{page}&limit=#{limit}", params: params)
+        def get_course_catalog(page: 1, limit: 20, params: {}, unique_user_id: nil)
+          get("v2/learn/course_catalog.json?page=#{page}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/learn/course_categories.rb

@@ -6,8 +6,8 @@ module MangoApps
       module CourseCategories
         # Get course categories from MangoApps Learn API
         # GET /api/v2/learn/course_categories.json
-        def get_course_categories(params: {})
-          get("v2/learn/course_categories.json", params: params)
+        def get_course_categories(params: {}, unique_user_id: nil)
+          get("v2/learn/course_categories.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/learn/course_details.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Learn
       module CourseDetails
-        def get_course_details(course_id, params = {})
-          get("v2/learn/courses/#{course_id}.json", params: params)
+        def get_course_details(course_id, params = {}, unique_user_id: nil)
+          get("v2/learn/courses/#{course_id}.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/learn/my_learning.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Learn
       module MyLearning
-        def get_my_learning(params = {})
-          get("v2/learn/my_learning.json", params: params)
+        def get_my_learning(params = {}, unique_user_id: nil)
+          get("v2/learn/my_learning.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/libraries/get_libraries.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Libraries
       module GetLibraries
-        def get_libraries(offset: 0, limit: 20, params: {})
-          get("users/libraries/get_libraries.json?offset=#{offset}&limit=#{limit}", params: params)
+        def get_libraries(offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("users/libraries/get_libraries.json?offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/libraries/get_library_categories.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Libraries
       module GetLibraryCategories
-        def get_library_categories(library_id, offset: 0, limit: 20, params: {})
-          get("users/libraries/#{library_id}.json?offset=#{offset}&limit=#{limit}", params: params)
+        def get_library_categories(library_id, offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("users/libraries/#{library_id}.json?offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/libraries/get_library_items.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Libraries
       module GetLibraryItems
-        def get_library_items(library_id, category_id, offset: 0, limit: 20, params: {})
-          get("users/libraries/#{library_id}/categories/#{category_id}/library_items/get_library_items.json?offset=#{offset}&limit=#{limit}", params: params)
+        def get_library_items(library_id, category_id, offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("users/libraries/#{library_id}/categories/#{category_id}/library_items/get_library_items.json?offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/notifications/my_priority_items.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Notifications
       module MyPriorityItems
-        def get_my_priority_items(params = {})
-          get("v2/uac.json", params: params)
+        def get_my_priority_items(params = {}, unique_user_id: nil)
+          get("v2/uac.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/notifications/notifications.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Notifications
       module Notifications
-        def get_notifications(offset: 0, limit: 20, params: {})
-          get("users/notifications.json?offset=#{offset}&limit=#{limit}", params: params)
+        def get_notifications(offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("users/notifications.json?offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/posts/get_all_posts.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Posts
       module GetAllPosts
-        def get_all_posts(filter_by: "all", offset: 0, limit: 20, params: {})
-          get("posts/get_all_posts.json?filter_by=#{filter_by}&offset=#{offset}&limit=#{limit}", params: params)
+        def get_all_posts(filter_by: "all", offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("posts/get_all_posts.json?filter_by=#{filter_by}&offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/posts/get_post_by_id.rb

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Posts
       module GetPostById
-        def get_post_by_id(post_id, params = {})
-          get("posts/#{post_id}.json", params: params)
+        def get_post_by_id(post_id, params = {}, unique_user_id: nil)
+          get("posts/#{post_id}.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Recognitions
       module AwardCategories
-        def get_award_categories(params: {})
-          get("v2/recognitions/get_award_categories.json", params: params)
+        def get_award_categories(params: {}, unique_user_id: nil)
+          get("v2/recognitions/get_award_categories.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Recognitions
       module CoreValueTags
-        def get_core_value_tags(params = {})
-          get("v2/recognitions/get_core_value_tags.json", params: params)
+        def get_core_value_tags(params = {}, unique_user_id: nil)
+          get("v2/recognitions/get_core_value_tags.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Recognitions
       module GetAwardsList
-        def get_awards_list(category_id, params: {})
-          get("v2/recognitions/get_awards_list.json?category_id=#{category_id}", params: params)
+        def get_awards_list(category_id, params: {}, unique_user_id: nil)
+          get("v2/recognitions/get_awards_list.json?category_id=#{category_id}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Recognitions
       module GetProfileAwards
-        def get_profile_awards(params = {})
-          get("v2/recognitions/get_profile_awards.json", params: params)
+        def get_profile_awards(params = {}, unique_user_id: nil)
+          get("v2/recognitions/get_profile_awards.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Recognitions
       module LeaderboardInfo
-        def get_leaderboard_info(params = {})
-          get("v2/recognitions/get_leaderboard_info.json", params: params)
+        def get_leaderboard_info(params = {}, unique_user_id: nil)
+          get("v2/recognitions/get_leaderboard_info.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Tasks
       module GetTaskDetails
-        def get_task_details(task_id, params = {})
-          get("tasks/#{task_id}.json", params: params)
+        def get_task_details(task_id, params = {}, unique_user_id: nil)
+          get("tasks/#{task_id}.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Tasks
       module GetTasks
-        def get_tasks(filter: "Pending_Tasks", page: 1, limit: 5, params: {})
-          get("tasks/new_index.json?filter=#{filter}&page=#{page}&limit=#{limit}", params: params)
+        def get_tasks(filter: "Pending_Tasks", page: 1, limit: 5, params: {}, unique_user_id: nil)
+          get("tasks/new_index.json?filter=#{filter}&page=#{page}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Trackers
       module GetTrackers
-        def get_trackers(page: 1, limit: 20, params: {})
-          get("v2/trackers.json?page=#{page}&limit=#{limit}", params: params)
+        def get_trackers(page: 1, limit: 20, params: {}, unique_user_id: nil)
+          get("v2/trackers.json?page=#{page}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/modules/users.rb

@@ -3,8 +3,17 @@
 module MangoApps
   class Client
     module Users
-      def me(params = {})
-        get("v2/me.json", params: params)
+      def me(params = {}, unique_user_id: nil)
+        get("v2/me.json", params: params, unique_user_id: unique_user_id)
+      end
+
+      def get_users(params = {}, offset: 0, limit: 20, unique_user_id: nil)
+        params = params.merge(offset: offset, limit: limit)
+        get("v2/users.json", params: params, unique_user_id: unique_user_id)
+      end
+
+      def get_user(user_id, params = {}, unique_user_id: nil)
+        get("v2/users/#{user_id}.json", params: params, unique_user_id: unique_user_id)
       end
     end
   end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Wikis
       module GetWikiDetails
-        def get_wiki_details(wiki_id, params = {})
-          get("v2/wikis/#{wiki_id}.json", params: params)
+        def get_wiki_details(wiki_id, params = {}, unique_user_id: nil)
+          get("v2/wikis/#{wiki_id}.json", params: params, unique_user_id: unique_user_id)
         end
       end
     end

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

@@ -4,8 +4,8 @@ module MangoApps
   class Client
     module Wikis
       module GetWikis
-        def get_wikis(mode: "my", offset: 0, limit: 20, params: {})
-          get("v2/wikis.json?mode=#{mode}&offset=#{offset}&limit=#{limit}", params: params)
+        def get_wikis(mode: "my", offset: 0, limit: 20, params: {}, unique_user_id: nil)
+          get("v2/wikis.json?mode=#{mode}&offset=#{offset}&limit=#{limit}", params: params, unique_user_id: unique_user_id)
         end
       end
     end

data/lib/mangoapps/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mangoapps-ex-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 19.1.1
+  version: 19.1.3
 platform: ruby
 authors:
 - MangoApps Inc.
 bindir: bin
 cert_chain: []
-date: 2025-09-19 00:00:00.000000000 Z
+date: 2025-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable