mangoapps-ex-sdk-ruby 19.1.1 → 19.1.2

data/README.md

@@ -1,25 +1,7 @@
 # MangoApps Ruby SDK
 
-A clean, **real TDD** Ruby SDK for MangoApps APIs with OAuth2/OpenID Connect authentication. Features intuitive dot notation access, automatic response wrapping, and comprehensive real-world testing with actual MangoApps credentials.
-
-## Features
-
-- 🔐 **OAuth2/OpenID Connect** authentication with automatic token refresh and userinfo endpoint
-- 🔑 **Internal API Authentication** - Alternative authentication using API keys for server-to-server communication
-- 🤖 **Automatic Authentication Detection** - Automatically detects and prioritizes Internal API over OAuth credentials
-- 📄 **Pagination Support** - All list APIs support optional page and limit parameters for efficient data retrieval
-- 🚀 **Simple API** with intuitive method names and clean dot notation
-- 🧪 **Real TDD** - no mocking, only actual OAuth testing
-- 🔄 **Automatic retries** with exponential backoff
-- 📝 **Comprehensive error handling** with specific exception types
-- 🛡️ **Security-first** design with PKCE support and HTTPS enforcement
-- 🔧 **Environment variable configuration** for secure credentials
-- 📚 **Well-documented** with examples and guides
-- ✨ **Clean Response API** - Automatic response wrapping with intuitive dot notation access
-- 🔔 **Notifications Module** - User priority items including requests, events, quizzes, surveys, tasks, and todos
-- 📰 **Feeds Module** - User activity feeds with unread counts and feed details
-- 📝 **Posts Module** - Get all posts with filtering options and post management
-- 🔒 **HTTPS Always** - All OAuth endpoints use HTTPS with automatic redirect handling
+A clean, Ruby SDK for MangoApps APIs with OAuth2/OpenID Connect authentication.
+
 
 ## Installation
 
@@ -41,83 +23,6 @@ Or install it directly:
 gem install mangoapps-ex-sdk-ruby
 ```
 
-**Current Version**: 0.15.2 (includes OAuth userinfo endpoint, HTTPS security enhancements, Internal API authentication, automatic authentication detection, and pagination support)
-
-## Quick Start
-
-### 1. Environment Setup
-
-For testing purposes, create a `.env` file with your MangoApps credentials:
-
-```bash
-# .env (for testing only)
-MANGOAPPS_DOMAIN=yourdomain.mangoapps.com
-
-# OAuth2 Authentication (Option 1)
-MANGOAPPS_CLIENT_ID=your_client_id_here
-MANGOAPPS_CLIENT_SECRET=your_client_secret_here
-MANGOAPPS_REDIRECT_URI=https://localhost:3000/oauth/callback
-MANGOAPPS_SCOPE=openid profile email
-
-# Internal API Authentication (Option 2 - Alternative to OAuth)
-# Contact MangoApps support team to get your Internal API Key and Secret
-MANGOAPPS_INTERNAL_API_KEY=your_internal_api_key
-MANGOAPPS_INTERNAL_API_SECRET=your_internal_api_secret
-```
-
-**Note**: The `.env` file is only used for testing. In production, you should handle token storage and management according to your application's security requirements.
-
-### 2. Rails Integration
-
-For Rails applications, see our comprehensive [Rails OAuth Guide](RAILS_OAUTH_GUIDE.md) which includes:
-
-- Simple OAuth 2.0 flow implementation
-- Token storage and management
-- OAuth userinfo endpoint integration
-- HTTPS security enforcement
-- Complete callback handling
-
-### 3. Configuration
-
-```ruby
-require "mangoapps"
-
-# For testing - automatically loads from .env file and detects authentication method
-config = MangoApps::Config.new
-# Output: 🔑 Using Internal API authentication (if internal API credentials found)
-# Output: 🔐 Using OAuth2 authentication (if OAuth credentials found)
-
-# For production - OAuth2 configuration
-config = MangoApps::Config.new(
-  domain: "yourdomain.mangoapps.com",
-  client_id: "your_client_id",
-  client_secret: "your_client_secret",
-  redirect_uri: "https://localhost:3000/oauth/callback",
-  scope: "openid profile email"
-)
-client = MangoApps::Client.new(config)
-
-# For production - Internal API configuration (Alternative to OAuth)
-# Note: Contact MangoApps support team to get your Internal API Key and Secret
-config = MangoApps::Config.new(
-  domain: "yourdomain.mangoapps.com",
-  internal_api_key: "your_internal_api_key",
-  internal_api_secret: "your_internal_api_secret"
-)
-client = MangoApps::Client.new(config)
-```
-
-### 3. OAuth Authentication
-
-#### Quick Start (Recommended)
-```bash
-# Get OAuth token (interactive)
-./run_auth.sh
-
-# Run tests to verify everything works
-./run_tests.sh
-```
-
 #### Basic Usage Example
 ```ruby
 require 'mangoapps-ex-sdk-ruby'
@@ -220,92 +125,7 @@ if wikis.wikis.any?
 end
 ```
 
-#### Manual OAuth Flow
-```ruby
-# Generate authorization URL
-state = SecureRandom.hex(16)
-auth_url = client.authorization_url(state: state)
-puts "Open this URL to authorize: #{auth_url}"
-
-# After user authorizes, exchange code for tokens
-tokens = client.authenticate!(authorization_code: params[:code])
-
-# Store tokens securely in your application
-# (implementation depends on your storage solution)
-store_tokens(tokens.access_token, tokens.refresh_token)
-
-# Now you can make API calls with clean dot notation
-user = client.me
-puts "Welcome, #{user.user_profile.minimal_profile.name}!"
-
-# Get OAuth user info from userinfo endpoint
-userinfo = client.get_userinfo
-puts "OAuth User: #{userinfo.name} (#{userinfo.email})"
-puts "Subject ID: #{userinfo.sub}"
-puts "Username: #{userinfo.preferred_username}"
-```
-
-#### OAuth Userinfo Endpoint
-
-The SDK provides access to the OAuth userinfo endpoint for getting authenticated user information:
-
-```ruby
-# Get user info from OAuth userinfo endpoint
-userinfo = client.get_userinfo
-
-# Access OAuth user data with clean dot notation
-puts "Name: #{userinfo.name}"
-puts "Email: #{userinfo.email}"
-puts "Subject ID: #{userinfo.sub}"
-puts "Username: #{userinfo.preferred_username}"
-
-# Available OAuth userinfo fields:
-# - sub: Subject identifier (unique user ID)
-# - name: Full name
-# - email: Email address
-# - preferred_username: Username
-# - email_verified: Email verification status
-# - locale: User locale
-# - zoneinfo: Timezone information
-```
-
-#### HTTPS Security Features
-
-The SDK enforces HTTPS for all OAuth operations:
-
-```ruby
-# Automatic HTTPS enforcement
-# - Discovery endpoints always use HTTPS
-# - Userinfo endpoints always use HTTPS
-# - Automatic redirect handling (301/302)
-# - SSL certificate verification
-
-# Example: Even if discovery returns HTTP URLs, they're converted to HTTPS
-config = MangoApps::Config.new(domain: "example.mangoapps.com")
-client = MangoApps::Client.new(config)
-
-# This will automatically use HTTPS
-userinfo = client.get_userinfo
-```
-
-### 4. Automatic Authentication Detection
-
-The SDK automatically detects and prioritizes authentication methods:
-
-1. **Internal API Credentials** (highest priority) - If `MANGOAPPS_INTERNAL_API_KEY` and `MANGOAPPS_INTERNAL_API_SECRET` are found
-2. **OAuth Credentials** (fallback) - If `MANGOAPPS_CLIENT_ID` and `MANGOAPPS_CLIENT_SECRET` are found
-
-```ruby
-# Automatic detection - no configuration needed
-config = MangoApps::Config.new
-# Shows: 🔑 Using Internal API authentication (if internal API found)
-# Shows: 🔐 Using OAuth2 authentication (if OAuth found)
-
-client = MangoApps::Client.new(config)
-# All API calls work automatically with detected authentication method
-```
-
-### 5. Pagination Support
+### Pagination Support
 
 Most list APIs support optional pagination parameters for efficient data retrieval:
 
@@ -337,803 +157,6 @@ items = client.get_library_items(library_id, category_id, offset: 0, limit: 15)
 - Tasks: `page: 1, limit: 5` (smaller default for task management)
 - Posts: `offset: 0, limit: 20` with `filter_by: "all"`
 
-### 6. Internal API Authentication (Alternative to OAuth)
-
-For applications that need direct API access without OAuth flow, you can use internal API authentication:
-
-> **📞 Getting API Credentials**: Contact the MangoApps support team to obtain your Internal API Key and Secret for server-to-server authentication.
-
-```ruby
-# Configure with internal API credentials
-config = MangoApps::Config.new(
-  domain: "yourdomain.mangoapps.com",
-  internal_api_key: "your_internal_api_key",
-  internal_api_secret: "your_internal_api_secret",
-)
-client = MangoApps::Client.new(config)
-
-# Use the SDK normally - authentication is handled automatically
-user = client.me
-puts "Hello, #{user.user_profile.minimal_profile.name}!"
-
-# Get user info (uses /me endpoint for internal API)
-userinfo = client.get_userinfo
-puts "User: #{userinfo.name} (#{userinfo.email})"
-
-# All other API calls work the same way
-posts = client.get_all_posts
-notifications = client.notifications
-```
-
-#### Internal API Headers
-
-The SDK automatically adds the required headers for internal API authentication:
-
-```ruby
-# These headers are automatically added to all requests:
-# - Internal-Api-Key: your_api_key
-# - Internal-Api-Secret: your_api_secret
-```
-
-#### When to Use Internal API vs OAuth
-
-- **OAuth2**: Use for user-facing applications where users need to authenticate
-- **Internal API**: Use for server-to-server communication, automation, or internal tools
-
-## Response Format
-
-The SDK automatically wraps all API responses in a `MangoApps::Response` object that provides clean dot notation access:
-
-```ruby
-# Clean dot notation access (automatic response wrapping):
-user = client.me
-name = user.user_profile.minimal_profile.name
-email = user.user_profile.minimal_profile.email
-```
-
-### Response Features
-
-- **🎯 Dot Notation Access**: `response.user.name` for clean, intuitive API access
-- **🔄 Automatic Wrapping**: All responses are automatically wrapped in `MangoApps::Response`
-- **🔗 Hash Compatibility**: Still supports `[]` access if needed
-- **📊 Enumerable Support**: Arrays and hashes work as expected
-- **🔍 Raw Data Access**: Use `response.raw_data` for original response
-- **⚡ Type Safety**: Better IDE support and autocomplete
-- **🎨 Clean Code**: No more verbose nested hash access
-
-## API Resources
-
-### Users Module
-
-```ruby
-# Get current user profile
-user = client.me
-
-# Access user data with clean dot notation
-puts "User: #{user.user_profile.minimal_profile.name}"
-puts "Email: #{user.user_profile.minimal_profile.email}"
-puts "Points: #{user.user_profile.gamification.total_points}"
-puts "Followers: #{user.user_profile.user_data.followers}"
-```
-
-### Learn Module
-
-#### Course Catalog
-```ruby
-# Get course catalog
-courses = client.course_catalog
-
-# Access course data with clean dot notation
-courses.courses.each do |course|
-  puts "#{course.name} - #{course.course_type}"
-end
-```
-
-#### Course Categories
-```ruby
-# Get all course categories (no pagination)
-categories = client.course_categories
-
-# Access category data with clean dot notation
-categories.all_categories.each do |category|
-  puts "#{category.name} - Position: #{category.position}"
-end
-```
-
-#### Course Details
-```ruby
-# Get detailed course information by course ID
-course_id = 604
-course = client.course_details(course_id)
-
-# Access course data with clean dot notation
-course_data = course.course
-puts "Course: #{course_data.name} (ID: #{course_data.id})"
-puts "Description: #{course_data.description}"
-puts "Type: #{course_data.course_type}"
-puts "Delivery Mode: #{course_data.delivery_mode}"
-puts "Instructors: #{course_data.instructors.length}"
-puts "Fields: #{course_data.fields.length}"
-
-# Access course URLs
-puts "Start Course URL: #{course_data.start_course_url}"
-puts "Go to Course URL: #{course_data.goto_course_url}"
-
-# Access course fields (details, certification, etc.)
-course_data.fields.each do |field|
-  puts "Field: #{field.field_name}"
-  field.course_sub_fields.each do |sub_field|
-    puts "  #{sub_field.field_name}: #{sub_field.field_value}"
-  end
-end
-```
-
-#### My Learning
-```ruby
-# Get user's learning progress and courses
-learning = client.my_learning
-
-# Access user learning data with clean dot notation
-puts "User: #{learning.user_name} (ID: #{learning.user_id})"
-puts "Total training time: #{learning.total_training_time}"
-puts "Ongoing courses: #{learning.ongoing_course_count}"
-puts "Completed courses: #{learning.completed_course_count}"
-puts "Registered courses: #{learning.registered_course_count}"
-
-# Access learning sections
-learning.section.each do |section|
-  puts "#{section.label} - #{section.count} courses"
-  
-  # Access courses in each section
-  section.courses.each do |course|
-    puts "  📚 #{course.name} - #{course.course_progress}% progress"
-  end
-end
-```
-
-### Recognitions Module
-
-#### Award Categories
-```ruby
-# Get award categories
-categories = client.award_categories
-
-# Access award category data with clean dot notation
-categories.award_categories.each do |category|
-  puts "#{category.name} (ID: #{category.id}) - Permission: #{category.recipient_permission}"
-end
-```
-
-#### Core Value Tags
-```ruby
-# Get core value tags
-tags = client.core_value_tags
-
-# Access core value tag data with clean dot notation
-tags.core_value_tags.each do |tag|
-  puts "#{tag.name} (ID: #{tag.id}) - Color: ##{tag.color}"
-end
-```
-
-#### Leaderboard Info
-```ruby
-# Get leaderboard information
-leaderboard = client.leaderboard_info
-
-# Check if leaderboard data is available
-if leaderboard.leaderboard_info
-  # Access user leaderboard with clean dot notation
-  leaderboard.leaderboard_info.user_info.each do |user|
-    puts "🏅 #{user.name} (Rank: #{user.rank}) - Awards: #{user.award_count}"
-  end
-  
-  # Access team leaderboard with clean dot notation
-  leaderboard.leaderboard_info.team_info.each do |team|
-    puts "🏆 #{team.name} (Rank: #{team.rank}) - Awards: #{team.award_count}"
-  end
-else
-  puts "No leaderboard data configured"
-end
-```
-
-
-
-#### Get Awards List
-```ruby
-# Get awards list for a specific category
-response = client.get_awards_list(category_id: 4303)
-
-# Access award data with clean dot notation
-response.get_awards_list.each do |award|
-  puts "#{award.name} (ID: #{award.id})"
-  puts "  Description: #{award.description}"
-  puts "  Points: #{award.points}"
-  puts "  Reward Points: #{award.reward_points}"
-  puts "  Image: #{award.attachment_url}"
-end
-```
-
-#### Get Profile Awards
-```ruby
-# Get user profile awards
-response = client.get_profile_awards
-
-# Access core value tags with counts
-response.core_value_tags.each do |tag|
-  puts "#{tag.name} (ID: #{tag.id}) - Count: #{tag.count}"
-end
-
-# Access award feeds
-response.feeds.each do |feed|
-  puts "#{feed.feed_property.title} - Points: #{feed.recognition_points}"
-  puts "From: #{feed.from_user.name}"
-  puts "Body: #{feed.body}"
-end
-```
-
-
-#### My Priority Items
-```ruby
-# Get user's priority items
-response = client.my_priority_items
-
-# Access priority items data
-response.data.each do |item|
-  puts "#{item.title} (ID: #{item.id}) - Count: #{item.count}"
-  puts "  Action Type: #{item.action_type}"
-  puts "  Icon: #{item.icon} (#{item.icon_color})"
-  puts "  Details: #{item.info_details}"
-end
-
-# Check response status
-puts "Success: #{response.success}"
-puts "Display Type: #{response.display_type}"
-```
-
-#### Feeds
-```ruby
-# Get user's activity feeds
-response = client.feeds
-
-# Access feeds data
-response.feeds.each do |feed|
-  puts "#{feed.feed_property.title} (ID: #{feed.id})"
-  puts "  From: #{feed.from_user.name} | Group: #{feed.group_name}"
-  puts "  Type: #{feed.feed_type} | Category: #{feed.category}"
-  puts "  Created: #{Time.at(feed.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "  Unread: #{feed.unread}"
-  puts "  Body: #{feed.body[0..100]}..."
-end
-
-# Access unread counts
-puts "Unread feeds: #{response.unread_counts.unread_feeds_count}"
-puts "Direct messages: #{response.unread_counts.direct_messages_count}"
-puts "What's new: #{response.unread_counts.whats_new_count}"
-
-# Check response metadata
-puts "Limit: #{response.limit} | Version: #{response.mangoapps_version}"
-```
-
-#### Get All Posts
-```ruby
-# Get all posts with filtering
-response = client.get_all_posts(filter_by: "all")
-
-# Access posts data
-response.feeds.each do |post|
-  puts "#{post.tile.tile_name} (ID: #{post.id})"
-  puts "  From: #{post.from_user.name} | Group: #{post.group_name}"
-  puts "  Post ID: #{post.post_id} | View count: #{post.total_view_count}"
-  puts "  Created: #{Time.at(post.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "  Comments: #{post.comments.length} | Likes: #{post.like_count}"
-  puts "  Content: #{post.tile.tile_content[0..100]}..."
-end
-
-# Access post configuration
-puts "Post view count visibility: #{response.post_view_count_visibility}"
-puts "Post view count link config: #{response.post_view_count_link_config}"
-```
-
-#### Get Post By ID
-```ruby
-# Get detailed post information by ID
-post_id = 59101
-response = client.get_post_by_id(post_id, full_description: "Y")
-
-# Access post details
-post = response.post
-puts "#{post.title} (ID: #{post.id})"
-puts "  Created by: #{post.created_name} (ID: #{post.creator_by})"
-puts "  Created: #{Time.at(post.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Conversation: #{post.conversation_name}"
-puts "  View count: #{post.total_view_count} | Likes: #{post.like_count} | Comments: #{post.comment_count}"
-
-# Access tile information
-if post.tile
-  puts "  Tile: #{post.tile.tile_name}"
-  puts "  Full description: #{post.tile.tile_full_description[0..200]}..."
-  puts "  Image: #{post.tile.tile_image}"
-end
-
-# Check post permissions
-puts "  Can edit: #{post.can_edit} | Can comment: #{post.can_comment} | Can delete: #{post.can_delete}"
-puts "  Is draft: #{post.is_draft} | Archived: #{post.archived}"
-```
-
-#### Libraries Management
-```ruby
-# Get user's document libraries
-libraries = client.get_libraries
-
-# Access libraries data
-puts "📚 User Libraries:"
-libraries.libraries.each do |library|
-  puts "  • #{library.name} (ID: #{library.id})"
-  puts "    Type: #{library.library_type} | View: #{library.view_mode}"
-  puts "    Items: #{library.total_items_count} | Categories: #{library.categories.length}"
-  puts "    Edit access: #{library.edit_access} | Position: #{library.position}"
-  puts "    Banner: #{library.banner_color} | Icon: #{library.icon_properties.color}"
-  
-  # Access library categories
-  if library.categories.any?
-    puts "    Categories:"
-    library.categories.first(3).each do |category|
-      puts "      - #{category.name} (#{category.library_items_count} items)"
-    end
-  end
-  puts ""
-end
-```
-
-#### Get Library Categories
-```ruby
-# Get detailed library information and categories by library ID
-library_id = 9776
-response = client.get_library_categories(library_id)
-
-# Access library details
-library = response.library
-puts "#{library.name} (ID: #{library.id})"
-puts "  Type: #{library.library_type} | View: #{library.view_mode}"
-puts "  Description: #{library.description}"
-puts "  Total items: #{library.total_items_count} | Categories: #{library.categories.length}"
-puts "  Edit access: #{library.edit_access} | Position: #{library.position}"
-
-# Access library properties
-puts "  Banner color: #{library.banner_color} | Icon color enabled: #{library.enable_icon_color}"
-puts "  Created: #{Time.at(library.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Updated: #{Time.at(library.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-
-# Access icon properties
-if library.icon_properties
-  puts "  Icon color: #{library.icon_properties.color} | Icon class: #{library.icon_properties.class}"
-end
-
-# Access categories
-if library.categories.any?
-  puts "  Categories:"
-  library.categories.each do |category|
-    puts "    • #{category.name} (ID: #{category.id})"
-    puts "      Items: #{category.library_items_count} | Rank: #{category.rank}"
-    puts "      Is system: #{category.is_system} | Icon: #{category.icon || 'None'}"
-    if category.description
-      puts "      Description: #{category.description[0..100]}..."
-    end
-  end
-end
-```
-
-#### Get Library Items
-```ruby
-# Get library items by library ID and category ID
-library_id = 9776
-category_id = 50114
-response = client.get_library_items(library_id, category_id)
-
-# Access library items data
-puts "Category: #{response.category_name}"
-puts "View mode: #{response.view_mode} | Library type: #{response.library_type}"
-puts "Library ID: #{response.library_id} | Can add: #{response.can_add}"
-puts "Icon color: #{response.enable_icon_color}"
-
-# Access library items
-if response.library_items.any?
-  puts "Library Items:"
-  response.library_items.each do |item|
-    puts "  • #{item.name} (ID: #{item.id})"
-    puts "    Link type: #{item.link_type} | Link: #{item.link[0..50]}..."
-    
-    # Handle different link types
-    if item.link_type == "ExternalLink"
-      if item.icon_properties
-        puts "    Icon: #{item.icon_properties.color} | Class: #{item.icon_properties.class}"
-      end
-    elsif item.link_type == "Attachment"
-      puts "    Attachment ID: #{item.attachment_id} | File type: #{item.file_type}"
-      puts "    Likes: #{item.likes_count} | Is liked: #{item.is_liked}"
-      puts "    Image: #{item.image_url}"
-      puts "    Short URL: #{item.short_url[0..50]}..."
-    end
-  end
-else
-  puts "No library items found"
-end
-```
-
-#### Trackers Management
-```ruby
-# Get user's trackers
-trackers = client.get_trackers
-
-# Access trackers data
-puts "📊 User Trackers:"
-puts "  Total trackers: #{trackers.trackers.length}"
-puts "  Transaction ID: #{trackers.transaction_id || 'None'}"
-puts ""
-
-# Display recent trackers
-puts "📊 Recent Trackers:"
-trackers.trackers.first(5).each do |tracker|
-  puts "  • #{tracker.name} (ID: #{tracker.id})"
-  puts "    Last submission: #{Time.at(tracker.last_submission_date.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "    Conversation: #{tracker.conversation_name} (ID: #{tracker.conversation_id})"
-  puts "    Pinned: #{tracker.is_pinned} | Can share: #{tracker.can_share}"
-  
-  # Access tracker icon info
-  if tracker.tracker_icon_info
-    puts "    Icon: #{tracker.tracker_icon_info.color_code} | Class: #{tracker.tracker_icon_info.icon_url}"
-  end
-  
-  puts "    MLink: #{tracker.mlink[0..50]}..."
-  puts ""
-end
-```
-
-#### Attachments Management
-```ruby
-# Get user's folders
-folders = client.get_folders
-
-# Access folders data
-puts "📁 User Folders:"
-puts "  Total folders: #{folders.folders.length}"
-puts "  Transaction ID: #{folders.transaction_id || 'None'}"
-puts ""
-
-# Display folders
-puts "📁 Available Folders:"
-folders.folders.each do |folder|
-  puts "  • #{folder.name} (ID: #{folder.id})"
-  puts "    Path: #{folder.relativePath}"
-  puts "    Child count: #{folder.child_count} | Can save: #{folder.can_save}"
-  puts "    Pinned: #{folder.is_pinned} | Virtual: #{folder.is_virtual_folder}"
-  puts "    Folder rel: #{folder.folder_rel} | Type: #{folder.folder_type_from_db || 'None'}"
-  puts "    Show in upload: #{folder.show_in_upload} | Show in move: #{folder.show_in_move}"
-  puts "    Filter: #{folder.filter} | Show permissions: #{folder.show_permission_options}"
-  
-  # Show conversation and user IDs if available
-  if folder.conversation_id
-    puts "    Conversation ID: #{folder.conversation_id}"
-  end
-  if folder.user_id
-    puts "    User ID: #{folder.user_id}"
-  end
-  
-  puts ""
-end
-```
-
-#### File and Folder Management
-```ruby
-# Get user's folders first
-folders = client.get_folders
-
-# Find a folder with content
-if folders.folders.any?
-  folder = folders.folders.find { |f| f.child_count.to_i > 0 }
-  
-  if folder
-    puts "📁 Exploring folder: #{folder.name} (ID: #{folder.id})"
-    
-    # Get files and folders inside this folder
-    folder_contents = client.get_folder_files(folder.id, include_folders: "Y")
-    
-    puts "📁 Folder Contents:"
-    puts "  Folder name: #{folder_contents.name}"
-    puts "  Total count: #{folder_contents.total_count}"
-    puts "  Role: #{folder_contents.role_name}"
-    puts "  Domain suspended: #{folder_contents.is_domain_suspended}"
-    puts "  Show in upload: #{folder_contents.show_in_upload}"
-    puts ""
-    
-    # Display files and folders
-    puts "📁 Files and Folders:"
-    folder_contents.files.first(10).each do |item|
-      puts "  • #{item.filename} (ID: #{item.id})"
-      puts "    Type: #{item.is_folder ? 'Folder' : 'File'}"
-      puts "    Size: #{item.size} bytes"
-      puts "    Uploader: #{item.uploader_name} (ID: #{item.user_id})"
-      puts "    Updated: #{Time.at(item.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-      puts "    Visibility: #{item.visibility} | Privacy: #{item.privacy_type}"
-      puts "    Pinned: #{item.is_pinned} | Liked: #{item.is_liked}"
-      puts "    Can save: #{item.can_save} | Show permissions: #{item.show_permission_options}"
-      
-      # Show role permissions
-      if item.role
-        puts "    Permissions: Edit: #{item.role.can_edit} | Share: #{item.role.can_share} | Restore: #{item.role.can_restore}"
-      end
-      
-      # Show links
-      if item.mLink
-        puts "    MLink: #{item.mLink[0..50]}..."
-      end
-      
-      puts ""
-    end
-  else
-    puts "No folders with content found"
-  end
-else
-  puts "No folders found"
-end
-```
-
-#### Task Management
-```ruby
-# Get user's tasks with filtering and pagination
-tasks = client.get_tasks(filter: "Pending_Tasks", page: 1, limit: 5)
-
-# Access tasks data
-puts "📋 User Tasks:"
-puts "  Total tasks: #{tasks.tasks.task.length}"
-puts "  Transaction ID: #{tasks.transaction_id || 'None'}"
-puts ""
-
-# Display tasks
-puts "📋 Task List:"
-tasks.tasks.task.each do |task|
-  puts "  • #{task.task_title} (ID: #{task.id})"
-  puts "    Status: #{task.status} | Bucket: #{task.bucket}"
-  puts "    Assigned to: #{task.assigned_to_name} (ID: #{task.assigned_to})"
-  puts "    Created by: #{task.creator_name} (ID: #{task.creator_id})"
-  puts "    Created: #{Time.at(task.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "    Assigned: #{Time.at(task.assigned_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "    Due: #{task.due} | Due on: #{task.due_on ? Time.at(task.due_on.to_i).strftime('%Y-%m-%d %H:%M:%S') : 'None'}"
-  puts "    Is overdue: #{task.is_overdue} | Can be started: #{task.task_can_be_started}"
-  puts "    Milestone: #{task.milestone_name || 'None'} (ID: #{task.milestone_id || 'None'})"
-  puts "    Project: #{task.conversation_name} (ID: #{task.project_id})"
-  puts "    Visibility: #{task.visibility} | Priority: #{task.personal_priority}"
-  
-  # Show reviewers
-  if task.reviewers && task.reviewers.reviewer
-    reviewers = task.reviewers.reviewer
-    puts "    Reviewers: #{reviewers.length} reviewers"
-    reviewers.first(3).each do |reviewer|
-      puts "      - #{reviewer.user_name} (Status: #{reviewer.status})"
-    end
-  end
-  
-  # Show next actions
-  if task.next_actions && task.next_actions.action
-    actions = task.next_actions.action
-    puts "    Available actions: #{actions.join(', ')}"
-  end
-  
-  # Show links
-  if task.mlink
-    puts "    MLink: #{task.mlink[0..50]}..."
-  end
-  
-  puts ""
-end
-```
-
-#### Task Details Management
-```ruby
-# Get detailed information for a specific task
-task_details = client.get_task_details("394153")
-
-# Access task details data
-puts "📋 Task Details:"
-puts "  Task ID: #{task_details.task.id}"
-puts "  Title: #{task_details.task.task_title}"
-puts "  Status: #{task_details.task.status} | Bucket: #{task_details.task.bucket}"
-puts "  Assigned to: #{task_details.task.assigned_to_name} (ID: #{task_details.task.assigned_to})"
-puts "  Created by: #{task_details.task.creator_name} (ID: #{task_details.task.creator_id})"
-puts "  Created: #{Time.at(task_details.task.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Assigned: #{Time.at(task_details.task.assigned_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Due: #{task_details.task.due} | Due on: #{task_details.task.due_on ? Time.at(task_details.task.due_on.to_i).strftime('%Y-%m-%d %H:%M:%S') : 'None'}"
-puts "  Is overdue: #{task_details.task.is_overdue} | Can be started: #{task_details.task.task_can_be_started}"
-puts "  Milestone: #{task_details.task.milestone_name || 'None'} (ID: #{task_details.task.milestone_id || 'None'})"
-puts "  Project: #{task_details.task.conversation_name} (ID: #{task_details.task.project_id})"
-puts "  Visibility: #{task_details.task.visibility} | Priority: #{task_details.task.personal_priority}"
-puts "  Transaction ID: #{task_details.transaction_id || 'None'}"
-puts ""
-
-# Show task timeline
-if task_details.task.started_on
-  puts "📅 Started: #{Time.at(task_details.task.started_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-end
-if task_details.task.finished_on
-  puts "📅 Finished: #{Time.at(task_details.task.finished_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-end
-if task_details.task.delivered_on
-  puts "📅 Delivered: #{Time.at(task_details.task.delivered_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-end
-
-# Show task history
-if task_details.task.reopened_on
-  puts "📅 Reopened: #{Time.at(task_details.task.reopened_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-end
-if task_details.task.restarted_on
-  puts "📅 Restarted: #{Time.at(task_details.task.restarted_on.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-end
-
-# Show reviewers
-if task_details.task.reviewers && task_details.task.reviewers.reviewer
-  reviewers = task_details.task.reviewers.reviewer
-  puts "👥 Reviewers: #{reviewers.length} reviewers"
-  reviewers.first(5).each do |reviewer|
-    puts "  - #{reviewer.user_name} (Status: #{reviewer.status})"
-  end
-end
-
-# Show next actions
-if task_details.task.next_actions && task_details.task.next_actions.action
-  actions = task_details.task.next_actions.action
-  puts "⚡ Available actions: #{actions.join(', ')}"
-end
-
-# Show task content
-if task_details.task.name
-  puts "📝 Task content: #{task_details.task.name[0..200]}..."
-end
-if task_details.task.notes
-  puts "📝 Notes: #{task_details.task.notes[0..200]}..."
-end
-
-# Show links
-if task_details.task.mlink
-  puts "🔗 MLink: #{task_details.task.mlink}"
-end
-
-# Show attachments
-if task_details.task.attachments
-  puts "📎 Attachments: #{task_details.task.attachments.length} attachments"
-end
-if task_details.task.attachment_references
-  puts "📎 Attachment references: #{task_details.task.attachment_references.length} references"
-end
-```
-
-#### Wiki Management
-```ruby
-# Get user's wikis with filtering and pagination
-wikis = client.get_wikis(mode: "my", limit: 20, offset: 0)
-
-# Access wikis data
-puts "📚 User Wikis:"
-puts "  Total wikis: #{wikis.wikis.length}"
-puts "  Transaction ID: #{wikis.transaction_id || 'None'}"
-puts ""
-
-# Display wikis
-puts "📚 Wiki List:"
-wikis.wikis.each do |wiki|
-  puts "  • #{wiki.title} (ID: #{wiki.id})"
-  puts "    Updated: #{Time.at(wiki.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-  puts "    Children: #{wiki.children_count} | Can edit: #{wiki.can_edit}"
-  puts "    Conversation: #{wiki.conversation_name || 'None'} (ID: #{wiki.conversation_id})"
-  puts "    Is draft: #{wiki.is_draft} | PDF access: #{wiki.generate_pdf_access}"
-  puts "    User: #{wiki.user_name || 'None'} | Status: #{wiki.status || 'None'}"
-  puts "    Governance enabled: #{wiki.governance_enabled} | Governance date: #{wiki.governance_date || 'None'}"
-  
-  # Show icon properties
-  if wiki.icon_properties
-    background_color = wiki.icon_properties.respond_to?(:'background-color') ? wiki.icon_properties.send(:'background-color') : nil
-    puts "    Icon: #{wiki.icon_properties.class} | Color: #{background_color || 'None'}"
-  end
-  
-  # Show user image URL
-  if wiki.user_image_url
-    puts "    User image: #{wiki.user_image_url[0..50]}..."
-  end
-  
-  puts ""
-end
-```
-
-#### Wiki Details Management
-```ruby
-# Get detailed information for a specific wiki
-wiki_details = client.get_wiki_details("7212")
-
-# Access wiki details data
-puts "📚 Wiki Details:"
-puts "  Wiki ID: #{wiki_details.wiki.details.id}"
-puts "  Title: #{wiki_details.wiki.details.title}"
-puts "  Status: #{wiki_details.wiki.details.status} | Platform: #{wiki_details.wiki.details.platform}"
-puts "  Created: #{Time.at(wiki_details.wiki.details.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Updated: #{Time.at(wiki_details.wiki.details.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
-puts "  Modified: #{wiki_details.wiki.details.modified_on}"
-puts "  Created by: #{wiki_details.wiki.details.created_by_name} (ID: #{wiki_details.wiki.details.user_id})"
-puts "  Updated by: #{wiki_details.wiki.details.updated_by_name} (ID: #{wiki_details.wiki.details.last_updated_by})"
-puts "  Conversation: #{wiki_details.wiki.details.conversation_name} (ID: #{wiki_details.wiki.details.conversation_id})"
-puts "  Read count: #{wiki_details.wiki.details.total_read_count} | Children: #{wiki_details.wiki.details.children_count}"
-puts "  Edit permissions: #{wiki_details.wiki.details.edit_permissions} | Commentable: #{wiki_details.wiki.details.is_commentable}"
-puts "  Generate PDF access: #{wiki_details.wiki.details.generate_pdf_access} | Show TOC: #{wiki_details.wiki.details.show_toc}"
-puts "  Has TOC: #{wiki_details.wiki.details.has_toc} | Archived: #{wiki_details.wiki.details.archived}"
-puts "  Domain ID: #{wiki_details.wiki.details.domain_id} | Feed ID: #{wiki_details.wiki.details.feed_id}"
-puts ""
-
-# Show wiki content
-if wiki_details.wiki.details.description
-  puts "📝 Description: #{wiki_details.wiki.details.description[0..300]}..."
-end
-
-# Show banner URL
-if wiki_details.wiki.details.banner_url
-  puts "🖼️ Banner URL: #{wiki_details.wiki.details.banner_url}"
-end
-
-# Show wiki permissions
-puts "🔐 Wiki Permissions:"
-puts "  Can comment: #{wiki_details.wiki.can_comment}"
-puts "  Can edit: #{wiki_details.wiki.can_edit}"
-puts "  Can delete: #{wiki_details.wiki.can_delete}"
-puts "  Can rename: #{wiki_details.wiki.can_rename}"
-puts "  Can move: #{wiki_details.wiki.can_move}"
-puts "  Can duplicate: #{wiki_details.wiki.can_duplicate}"
-
-# Show wiki links
-if wiki_details.wiki.mlink
-  puts "🔗 MLink: #{wiki_details.wiki.mlink}"
-end
-
-# Show attachments
-if wiki_details.wiki.attachments
-  puts "📎 Attachments: #{wiki_details.wiki.attachments.length} attachments"
-end
-if wiki_details.wiki.attachment_references
-  puts "📎 Attachment references: #{wiki_details.wiki.attachment_references.length} references"
-end
-
-# Show reactions
-if wiki_details.wiki.reactions
-  reactions = wiki_details.wiki.reactions
-  puts "👍 Reactions: Like: #{reactions.like_count}, Superlike: #{reactions.superlike_count}"
-  puts "😄 Reactions: Haha: #{reactions.haha_count}, Yay: #{reactions.yay_count}, Wow: #{reactions.wow_count}, Sad: #{reactions.sad_count}"
-  puts "👤 User reactions: Liked: #{reactions.liked}, Superliked: #{reactions.superliked}"
-end
-
-# Show reaction data
-if wiki_details.wiki.reaction_data
-  reaction_data = wiki_details.wiki.reaction_data
-  puts "📊 Reaction data: #{reaction_data.length} reaction types"
-  reaction_data.each do |reaction|
-    puts "  - #{reaction.label}: #{reaction.count} (Reacted: #{reaction.reacted})"
-  end
-end
-
-# Show comment count
-puts "💬 Comment count: #{wiki_details.wiki.comment_count}"
-
-# Show wiki status
-puts "📌 Is pinned: #{wiki_details.wiki.is_pinned}"
-puts "📄 Is draft: #{wiki_details.wiki.is_draft}"
-puts "🔒 Governance enabled: #{wiki_details.wiki.governance_enabled}"
-
-# Show hashtags
-if wiki_details.wiki.hashtags
-  hashtags = wiki_details.wiki.hashtags
-  puts "🏷️ Hashtags: #{hashtags.length} hashtags"
-  hashtags.each do |hashtag|
-    puts "  - #{hashtag}"
-  end
-end
-```
-
-
 ## Available Modules
 
 ### ✅ Currently Implemented
@@ -1737,64 +760,6 @@ config = MangoApps::Config.new(
 # - SSL certificate verification enabled
 ```
 
-
-## Development
-
-### For SDK Users
-
-If you're using this SDK in your application, you only need:
-
-1. **Install the gem**: `gem install mangoapps-ex-sdk-ruby`
-2. **Configure OAuth**: Set up your MangoApps OAuth credentials
-3. **Start coding**: Use the examples above
-
-### For SDK Developers
-
-If you're contributing to or extending this SDK, see our comprehensive developer documentation:
-
-📚 **[DEVELOPER.md](DEVELOPER.md)** - Complete guide for SDK development including:
-- Adding new APIs and modules
-- Testing guidelines (real TDD approach)
-- Development workflow
-- Code style and standards
-- Module architecture
-- Error handling
-- Documentation standards
-- Release process
-
-### Quick Development Setup
-
-```bash
-git clone https://github.com/MangoAppsInc/mangoapps-ex-sdk-ruby.git
-cd mangoapps-ex-sdk-ruby
-cp .env.example .env
-# Edit .env with your MangoApps credentials (for testing only)
-bundle install
-```
-
-### Testing the SDK
-
-This SDK uses **real TDD** - no mocking, only actual OAuth testing:
-
-```bash
-# Get OAuth token (first time or when expired)
-./run_auth.sh
-
-# Run tests
-./run_tests.sh
-
-# Run specific module tests
-./run_tests.sh learn
-./run_tests.sh users  
-./run_tests.sh recognitions
-./run_tests.sh notifications
-./run_tests.sh feeds
-./run_tests.sh posts
-
-# Interactive testing
-./run_irb.sh
-```
-
 ### Current API Coverage
 
 - ✅ **Learn Module**: Course catalog, categories, course details, and my learning (4 endpoints)
@@ -1838,4 +803,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
-See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.
+See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.