mangoapps-ex-sdk-ruby 0.15.2

data/README.md

@@ -0,0 +1,2040 @@
+# 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
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "mangoapps-ex-sdk-ruby"
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it directly:
+
+```bash
+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=824938b1a5ea1c29d472ba79254d68b62ce8e5df
+MANGOAPPS_INTERNAL_API_SECRET=387103e2c91779d3bafb1a713bfa99a5
+MANGOAPPS_TEST_HEADER=test1111
+```
+
+**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: "824938b1a5ea1c29d472ba79254d68b62ce8e5df",
+  internal_api_secret: "387103e2c91779d3bafb1a713bfa99a5",
+  test_header: "test1111"  # Optional
+)
+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'
+
+# Initialize client
+client = MangoApps::Client.new
+
+# Get user profile
+user = client.me
+puts "Hello, #{user.name}!"
+
+# Get OAuth user info (from OAuth userinfo endpoint)
+userinfo = client.get_userinfo
+puts "OAuth User: #{userinfo.name} (#{userinfo.email})"
+puts "Username: #{userinfo.preferred_username}"
+puts "Subject ID: #{userinfo.sub}"
+
+# Get priority items
+priority_items = client.my_priority_items
+puts "You have #{priority_items.data.length} priority items:"
+priority_items.data.each do |item|
+  puts "  • #{item.title}: #{item.count} pending"
+end
+
+# Get available courses
+courses = client.course_catalog
+puts "Available courses: #{courses.courses.length}"
+
+# Get activity feeds
+feeds = client.feeds
+puts "Activity feeds: #{feeds.feeds.length} (unread: #{feeds.unread_counts.unread_feeds_count})"
+
+# Get all posts
+posts = client.get_all_posts(filter_by: "all")
+puts "All posts: #{posts.feeds.length}"
+
+# Get post details by ID
+if posts.feeds.any?
+  post_id = posts.feeds.first.post_id
+  post_details = client.get_post_by_id(post_id, full_description: "Y")
+  puts "Post details: #{post_details.post.title}"
+end
+
+# Get user libraries
+libraries = client.get_libraries
+puts "User libraries: #{libraries.libraries.length}"
+
+# Get library categories by ID
+if libraries.libraries.any?
+  library_id = libraries.libraries.first.id
+  library_details = client.get_library_categories(library_id)
+  puts "Library details: #{library_details.library.name}"
+  
+  # Get library items from first category
+  if library_details.library.categories.any?
+    category_id = library_details.library.categories.first.id
+    library_items = client.get_library_items(library_id, category_id)
+    puts "Library items: #{library_items.library_items.length} items in #{library_items.category_name}"
+  end
+end
+
+# Get user trackers
+trackers = client.get_trackers
+puts "User trackers: #{trackers.trackers.length}"
+
+# Get user folders
+folders = client.get_folders
+puts "User folders: #{folders.folders.length}"
+
+# Get files from first folder with content
+if folders.folders.any?
+  folder_with_content = folders.folders.find { |f| f.child_count.to_i > 0 }
+  if folder_with_content
+    folder_files = client.get_folder_files(folder_with_content.id, include_folders: "Y")
+    puts "Folder files: #{folder_files.files.length} items in #{folder_files.name}"
+  end
+end
+
+# Get user tasks
+tasks = client.get_tasks(filter: "Pending_Tasks", page: 1, limit: 3)
+puts "User tasks: #{tasks.tasks.task.length}"
+
+# Get detailed information for a specific task
+if tasks.tasks.task.any?
+  first_task = tasks.tasks.task.first
+  task_id = first_task.is_a?(Array) ? first_task[1] : first_task.id
+  task_details = client.get_task_details(task_id)
+  puts "Task details: #{task_details.task.task_title} (Status: #{task_details.task.status})"
+end
+
+# Get user wikis
+wikis = client.get_wikis(mode: "my", limit: 5, offset: 0)
+puts "User wikis: #{wikis.wikis.length}"
+
+# Get detailed information for the first wiki
+if wikis.wikis.any?
+  first_wiki = wikis.wikis.first
+  wiki_details = client.get_wiki_details(first_wiki.id)
+  puts "Wiki details: #{wiki_details.wiki.details.title} (Read count: #{wiki_details.wiki.details.total_read_count})"
+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
+
+All list APIs support optional pagination parameters for efficient data retrieval:
+
+```ruby
+# Basic usage with default pagination
+posts = client.get_all_posts
+courses = client.course_catalog
+
+# Pagination with custom page and limit
+posts = client.get_all_posts(page: 2, limit: 10)
+courses = client.course_catalog(page: 1, limit: 5)
+
+# Filtering with pagination
+posts = client.get_all_posts(filter_by: "all", page: 1, limit: 20)
+tasks = client.get_tasks(filter: "Pending_Tasks", page: 1, limit: 10)
+
+# Library items with pagination
+items = client.get_library_items(library_id, category_id, page: 1, limit: 15)
+```
+
+**Default Pagination Values:**
+- Most APIs: `page: 1, limit: 20`
+- Tasks: `page: 1, limit: 5` (smaller default for task management)
+- Posts: `page: 1, 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: "824938b1a5ea1c29d472ba79254d68b62ce8e5df",
+  internal_api_secret: "387103e2c91779d3bafb1a713bfa99a5",
+)
+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
+# - Test: your_test_header (if provided)
+```
+
+#### 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
+categories = client.course_categories
+
+# Access category data with clean dot notation
+categories.all_categories.each do |category|
+  puts "#{category.name} - Position: #{category.position}"
+end
+
+# Get specific category details
+category = client.course_category(category_id)
+```
+
+#### 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
+```
+
+#### Tango Gift Cards
+```ruby
+# Get tango gift cards information
+gift_cards = client.tango_gift_cards
+
+# Access gift card data with clean dot notation
+puts "Available points: #{gift_cards.tango_cards.available_points}"
+puts "Terms: #{gift_cards.tango_cards.terms}"
+```
+
+#### Gift Cards
+```ruby
+# Get gift cards information
+gift_cards = client.gift_cards
+
+# Access gift card data with clean dot notation
+gift_cards.cards.each do |card|
+  puts "#{card.brand_name} (Key: #{card.brand_key}) - Enabled: #{card.enabled}"
+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
+```
+
+#### Get Team Awards
+```ruby
+# Get team awards for a specific project/team
+response = client.get_team_awards(project_id: 117747)
+
+# Access team core value tags with counts
+response.core_value_tags.each do |tag|
+  puts "#{tag.name} (ID: #{tag.id}) - Count: #{tag.count}"
+end
+
+# Access team award feeds
+response.feeds.each do |feed|
+  puts "#{feed.feed_property.title} - Points: #{feed.recognition_points}"
+  puts "From: #{feed.from_user.name}"
+  puts "Team: #{feed.group_name} (ID: #{feed.group_id})"
+  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
+```
+
+#### Award Feeds Management
+```ruby
+# Get award feeds with comprehensive recognition data
+award_feeds = client.get_award_feeds
+
+# Access award feeds data
+puts "🏆 Award Feeds:"
+puts "  Transaction ID: #{award_feeds.transaction_id || 'None'}"
+puts "  Limit: #{award_feeds.limit || 'None'}"
+puts "  Current priority: #{award_feeds.current_priority || 'None'}"
+puts "  Enable mobile pin: #{award_feeds.enable_mobile_pin}"
+puts "  MangoApps version: #{award_feeds.mangoapps_version}"
+puts "  Comments order: #{award_feeds.comments_order}"
+puts "  Private message reply order: #{award_feeds.private_message_reply_order || 'None'}"
+puts "  Photo shape: #{award_feeds.photo_shape || 'None'}"
+puts "  Moderation feed IDs: #{award_feeds.moderation_feed_ids || 'None'}"
+puts "  Moderation HTML: #{award_feeds.moderation_html || 'None'}"
+puts ""
+
+# Show unread counts
+if award_feeds.unread_counts
+  unread_counts = award_feeds.unread_counts
+  puts "📊 Unread Counts:"
+  puts "  Direct messages: #{unread_counts.direct_messages_count}"
+  puts "  What's new: #{unread_counts.whats_new_count}"
+  puts "  Unread feeds: #{unread_counts.unread_feeds_count}"
+  puts "  Mentions: #{unread_counts.mention_count}"
+  puts "  Primary unread: #{unread_counts.primary_unread_count}"
+  puts "  Secondary unread: #{unread_counts.secondary_unread_count}"
+  puts "  Unread notifications: #{unread_counts.unread_notification_count}"
+  puts ""
+end
+
+# Display award feeds
+puts "🏆 Award Feed List:"
+award_feeds.feeds.each do |feed|
+  puts "  • Feed ID: #{feed.id} | Type: #{feed.feed_type}"
+  puts "    Category: #{feed.category} | Sub-category: #{feed.sub_category}"
+  puts "    Recognition points: #{feed.recognition_points}"
+  puts "    From: #{feed.from_user.name if feed.from_user} | To: #{feed.to_users.length if feed.to_users} users"
+  puts "    Reactions: Like: #{feed.like_count}, Superlike: #{feed.superlike_count}"
+  puts "    Comments: #{feed.comment_count} | Attachments: #{feed.attachment_count}"
+  puts "    Created: #{Time.at(feed.created_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
+  puts "    Updated: #{Time.at(feed.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
+  
+  # Show award details
+  if feed.feed_property
+    puts "    Award: #{feed.feed_property.title}"
+    puts "    Labels: #{feed.feed_property.label_1}, #{feed.feed_property.label_2}"
+    puts "    Image URL: #{feed.feed_property.image_url[0..50]}..." if feed.feed_property.image_url
+    puts "    Status: #{feed.feed_property.status} | Result format: #{feed.feed_property.result_format}"
+  end
+  
+  # Show from user
+  if feed.from_user
+    puts "    From user: #{feed.from_user.name} (ID: #{feed.from_user.id})"
+    puts "    Email: #{feed.from_user.email}"
+    puts "    Photo: #{feed.from_user.photo[0..50]}..." if feed.from_user.photo
+  end
+  
+  # Show to users
+  if feed.to_users
+    puts "    To users: #{feed.to_users.length} users"
+    feed.to_users.each do |user|
+      puts "      - #{user.name} (ID: #{user.id})"
+    end
+  end
+  
+  # Show feed story users
+  if feed.feed_story_users
+    puts "    Story users: #{feed.feed_story_users.length} users"
+    feed.feed_story_users.each do |user|
+      puts "      - #{user.name} (ID: #{user.id})"
+    end
+  end
+  
+  # Show core value tags
+  if feed.core_value_tags
+    puts "    Core value tags: #{feed.core_value_tags.length} tags"
+    feed.core_value_tags.each do |tag|
+      puts "      - #{tag.name} (ID: #{tag.id}, Color: #{tag.color})"
+    end
+  end
+  
+  # Show reaction data
+  if feed.reaction_data
+    puts "    Reaction data: #{feed.reaction_data.length} reaction types"
+    feed.reaction_data.each do |reaction|
+      puts "      - #{reaction.label}: #{reaction.count} (Reacted: #{reaction.reacted})"
+    end
+  end
+  
+  # Show comments
+  if feed.comments
+    puts "    Comments: #{feed.comments.length} comments"
+    feed.comments.first(3).each do |comment|
+      puts "      - #{comment.body[0..50]}... by #{comment.user.name if comment.user}"
+    end
+  end
+  
+  puts ""
+end
+```
+
+## Available Modules
+
+### ✅ Currently Implemented
+
+#### Users Module
+- **User Profile**: `client.me` - Get current user information with clean dot notation access
+
+#### Learn Module  
+- **Course Catalog**: `client.course_catalog` - Get available courses
+- **Course Categories**: `client.course_categories` - Get course categories
+- **Course Details**: `client.course_details(course_id)` - Get detailed course information by ID
+- **My Learning**: `client.my_learning` - Get user's learning progress and courses
+
+#### Recognitions Module
+- **Award Categories**: `client.award_categories` - Get recognition award categories
+- **Get Awards List**: `client.get_awards_list(category_id: id)` - Get awards for a specific category
+- **Get Profile Awards**: `client.get_profile_awards` - Get user's personal awards and activity
+- **Get Team Awards**: `client.get_team_awards(project_id: id)` - Get team awards and activity
+- **Get Award Feeds**: `client.get_award_feeds` - Get award feeds with comprehensive recognition data
+- **Core Value Tags**: `client.core_value_tags` - Get core value tags for recognition
+- **Leaderboard Info**: `client.leaderboard_info` - Get user and team leaderboard information
+- **Gift Cards**: `client.gift_cards` - Get available gift cards for recognition rewards
+
+#### Notifications Module
+- **My Priority Items**: `client.my_priority_items` - Get user's priority items including requests, events, quizzes, surveys, tasks, and todos
+- **Notifications**: `client.notifications` - Get user's notifications with unread counts and detailed notification information
+
+#### Feeds Module
+- **Feeds**: `client.feeds` - Get user's activity feeds with unread counts and feed details
+
+#### Posts Module
+- **Get All Posts**: `client.get_all_posts(filter_by: "all")` - Get all posts with filtering options
+- **Get Post By ID**: `client.get_post_by_id(post_id, full_description: "Y")` - Get detailed post information by ID
+
+#### Libraries Module
+- **Get Libraries**: `client.get_libraries` - Get user's document libraries with categories and items
+- **Get Library Categories**: `client.get_library_categories(library_id)` - Get detailed library information and categories by library ID
+- **Get Library Items**: `client.get_library_items(library_id, category_id)` - Get library items by library ID and category ID
+
+#### Trackers Module
+- **Get Trackers**: `client.get_trackers` - Get user's trackers with submission dates and conversation details
+
+#### Attachments Module
+- **Get Folders**: `client.get_folders` - Get user's file folders with permissions and metadata
+- **Get Folder Files**: `client.get_folder_files(folder_id, include_folders: "Y")` - Get files and folders inside a specific folder
+
+#### Tasks Module
+- **Get Tasks**: `client.get_tasks(filter: "Pending_Tasks", page: 1, limit: 5)` - Get user's tasks with filtering, pagination, and detailed task information
+- **Get Task Details**: `client.get_task_details(task_id)` - Get detailed information for a specific task by ID
+
+#### Wikis Module
+- **Get Wikis**: `client.get_wikis(mode: "my", limit: 20, offset: 0)` - Get user's wikis with filtering, pagination, and detailed wiki information
+- **Get Wiki Details**: `client.get_wiki_details(wiki_id)` - Get detailed information for a specific wiki by ID
+
+## Complete Examples
+
+### Notifications Management
+```ruby
+require 'mangoapps-ex-sdk-ruby'
+
+# Initialize client
+client = MangoApps::Client.new
+
+# Get user's priority items
+priority_items = client.my_priority_items
+
+# Display all priority items with details
+puts "🔔 User Priority Items Dashboard"
+puts "================================"
+puts "Success: #{priority_items.success}"
+puts "Display Type: #{priority_items.display_type}"
+puts ""
+
+priority_items.data.each do |item|
+  puts "📋 #{item.title} (ID: #{item.id})"
+  puts "   Count: #{item.count} pending items"
+  puts "   Action Type: #{item.action_type}"
+  puts "   Icon: #{item.icon} (#{item.icon_color})"
+  puts "   Background: #{item.icon_bg_color}"
+  puts "   Description: #{item.info_details.gsub(/<[^>]*>/, '').strip[0..100]}..."
+  puts ""
+end
+
+# Get user's notifications
+notifications = client.notifications
+
+# Display notifications dashboard
+puts "🔔 User Notifications Dashboard"
+puts "==============================="
+puts "What's new: #{notifications.whats_new_count}"
+puts "Unread feeds: #{notifications.unread_feeds_count}"
+puts "Mentions: #{notifications.mention_count}"
+puts "Direct messages: #{notifications.direct_messages_count}"
+puts "Unread notifications: #{notifications.unread_notification_count}"
+puts ""
+
+notifications.notifications.first(5).each do |notification|
+  puts "📢 #{notification.sender_name} (ID: #{notification.id})"
+  puts "   Text: #{notification.text[0..100]}..."
+  puts "   Type: #{notification.notification_type || 'None'}"
+  puts "   Read: #{notification.is_read} | Updated: #{Time.at(notification.updated_at.to_i).strftime('%Y-%m-%d %H:%M:%S')}"
+  puts "   MLink: #{notification.mlink || 'None'}"
+  if notification.mention_tags && notification.mention_tags.any?
+    puts "   Mentions: #{notification.mention_tags.map { |tag| tag.mention }.join(', ')}"
+  end
+  puts ""
+end
+
+# Filter by specific action types
+approval_items = priority_items.data.select { |item| item.action_type == 'approval' }
+puts "🔍 Approval Items: #{approval_items.length}"
+approval_items.each do |item|
+  puts "  • #{item.title}: #{item.count} items"
+end
+
+# Get high-priority items (count > 5)
+high_priority = priority_items.data.select { |item| item.count > 5 }
+puts "⚠️  High Priority Items: #{high_priority.length}"
+high_priority.each do |item|
+  puts "  • #{item.title}: #{item.count} items"
+end
+```
+
+### User Profile Management
+```ruby
+# Get current user profile
+user = client.me
+
+# Access user information with clean dot notation
+puts "Name: #{user.user_profile.minimal_profile.name}"
+puts "Email: #{user.user_profile.minimal_profile.email}"
+puts "User Type: #{user.user_profile.minimal_profile.user_type}"
+
+# Access user statistics
+puts "Followers: #{user.user_profile.user_data.followers}"
+puts "Following: #{user.user_profile.user_data.following}"
+
+# Access gamification data
+puts "Current Level: #{user.user_profile.gamification.current_level}"
+puts "Total Points: #{user.user_profile.gamification.total_points}"
+puts "Badges: #{user.user_profile.gamification.badges.length}"
+
+# Access recognition data
+puts "Reward Points Received: #{user.user_profile.recognition.total_reward_points_received}"
+```
+
+### Learning Management
+```ruby
+# Get course catalog
+courses = client.course_catalog
+
+# Browse available courses
+courses.courses.each do |course|
+  puts "📚 #{course.name}"
+  puts "   Type: #{course.course_type}"
+  puts "   Delivery: #{course.delivery_mode}"
+  puts "   URL: #{course.start_course_url}"
+  puts ""
+  
+  # Get detailed course information
+  course_details = client.course_details(course.id)
+  detailed_course = course_details.course
+  puts "   📖 Detailed Info:"
+  puts "   Description: #{detailed_course.description}"
+  puts "   Instructors: #{detailed_course.instructors.length}"
+  puts "   Fields: #{detailed_course.fields.length}"
+  puts ""
+end
+
+# Get course categories
+categories = client.course_categories
+
+# Browse course categories
+categories.all_categories.each do |category|
+  puts "📂 #{category.name}"
+  puts "   Position: #{category.position}"
+  puts "   Icon: #{category.icon_properties}"
+  puts ""
+end
+
+# Get user's learning progress
+learning = client.my_learning
+
+# Display learning summary
+puts "🎓 Learning Summary for #{learning.user_name}"
+puts "⏱️ Total training time: #{learning.total_training_time}"
+puts "📚 Ongoing: #{learning.ongoing_course_count} | ✅ Completed: #{learning.completed_course_count} | 📝 Registered: #{learning.registered_course_count}"
+puts ""
+
+# Browse learning sections
+learning.section.each do |section|
+  puts "📂 #{section.label} (#{section.count} courses)"
+  
+  section.courses.each do |course|
+    puts "  📚 #{course.name}"
+    puts "     Progress: #{course.course_progress}%"
+    puts "     Type: #{course.course_type}"
+    puts "     URL: #{course.start_course_url}"
+    puts ""
+  end
+end
+```
+
+### Recognition Management
+```ruby
+# Get award categories
+categories = client.award_categories
+
+# Display available award categories
+puts "🏆 Available Award Categories:"
+categories.award_categories.each do |category|
+  puts "  • #{category.name} (ID: #{category.id})"
+  puts "    Permission: #{category.recipient_permission}"
+end
+puts ""
+
+# Get awards for a specific category
+category_id = 4303  # Safety & Quality category
+awards = client.get_awards_list(category_id: category_id)
+
+# Display awards in the category
+puts "🏆 Awards in Category #{category_id}:"
+awards.get_awards_list.each do |award|
+  puts "  • #{award.name} (ID: #{award.id})"
+  puts "    Points: #{award.points} | Reward Points: #{award.reward_points || 'None'}"
+  puts "    Description: #{award.description}"
+end
+puts ""
+
+# Get user profile awards
+profile_awards = client.get_profile_awards
+
+# Display user's personal awards
+puts "🏆 User Profile Awards:"
+puts "  Core Value Tags:"
+profile_awards.core_value_tags.each do |tag|
+  puts "    • #{tag.name} (ID: #{tag.id}) - Count: #{tag.count}"
+end
+puts "  Recent Awards:"
+profile_awards.feeds.each do |feed|
+  puts "    • #{feed.feed_property.title} - Points: #{feed.recognition_points}"
+  puts "      From: #{feed.from_user.name}"
+end
+puts ""
+
+# Get team awards
+team_id = 117747  # All Users team
+team_awards = client.get_team_awards(project_id: team_id)
+
+# Display team awards
+puts "🏆 Team Awards (Team ID: #{team_id}):"
+puts "  Team Core Value Tags:"
+team_awards.core_value_tags.each do |tag|
+  puts "    • #{tag.name} (ID: #{tag.id}) - Count: #{tag.count}"
+end
+puts "  Team Recent Awards:"
+team_awards.feeds.each do |feed|
+  puts "    • #{feed.feed_property.title} - Points: #{feed.recognition_points}"
+  puts "      From: #{feed.from_user.name} | Team: #{feed.group_name}"
+end
+puts ""
+
+# Get user priority items
+priority_items = client.my_priority_items
+
+# Display priority items
+puts "🔔 User Priority Items:"
+priority_items.data.each do |item|
+  puts "  • #{item.title} (ID: #{item.id}) - Count: #{item.count}"
+  puts "    Action Type: #{item.action_type} | Icon: #{item.icon}"
+end
+puts ""
+
+# Get user activity feeds
+feeds = client.feeds
+
+# Display feeds
+puts "📰 User Activity Feeds:"
+puts "  Total feeds: #{feeds.feeds.length}"
+puts "  Unread feeds: #{feeds.unread_counts.unread_feeds_count}"
+puts "  Direct messages: #{feeds.unread_counts.direct_messages_count}"
+puts "  What's new: #{feeds.unread_counts.whats_new_count}"
+puts ""
+
+# Display recent feeds
+puts "📰 Recent Feeds:"
+feeds.feeds.first(3).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} | Unread: #{feed.unread}"
+end
+puts ""
+
+# Get all posts
+posts = client.get_all_posts(filter_by: "all")
+
+# Display posts
+puts "📝 All Posts:"
+puts "  Total posts: #{posts.feeds.length}"
+puts "  Post view count visibility: #{posts.post_view_count_visibility}"
+puts ""
+
+# Display recent posts
+puts "📝 Recent Posts:"
+posts.feeds.first(3).each do |post|
+  puts "  • #{post.tile.tile_name} (ID: #{post.id})"
+  puts "    From: #{post.from_user.name} | Group: #{post.group_name}"
+  puts "    Views: #{post.total_view_count} | Comments: #{post.comments.length}"
+end
+puts ""
+
+# Get detailed post information
+if posts.feeds.any?
+  first_post_id = posts.feeds.first.post_id
+  post_details = client.get_post_by_id(first_post_id, full_description: "Y")
+  
+  puts "📝 Post Details (ID: #{first_post_id}):"
+  puts "  Title: #{post_details.post.title}"
+  puts "  Created by: #{post_details.post.created_name}"
+  puts "  View count: #{post_details.post.total_view_count}"
+  puts "  Can edit: #{post_details.post.can_edit} | Can comment: #{post_details.post.can_comment}"
+  puts "  Full description available: #{post_details.post.tile.tile_full_description.length > 0 ? 'Yes' : 'No'}"
+end
+puts ""
+
+# Get user libraries
+libraries = client.get_libraries
+
+puts "📚 User Libraries:"
+puts "  Total libraries: #{libraries.libraries.length}"
+puts ""
+
+# Display recent libraries
+puts "📚 Recent Libraries:"
+libraries.libraries.first(3).each do |library|
+  puts "  • #{library.name} (ID: #{library.id})"
+  puts "    Type: #{library.library_type} | Items: #{library.total_items_count}"
+  puts "    Categories: #{library.categories.length} | Edit access: #{library.edit_access}"
+end
+puts ""
+
+# Get detailed library information
+if libraries.libraries.any?
+  first_library_id = libraries.libraries.first.id
+  library_details = client.get_library_categories(first_library_id)
+  
+  puts "📚 Library Details (ID: #{first_library_id}):"
+  puts "  Name: #{library_details.library.name}"
+  puts "  Type: #{library_details.library.library_type} | View: #{library_details.library.view_mode}"
+  puts "  Total items: #{library_details.library.total_items_count}"
+  puts "  Categories: #{library_details.library.categories.length}"
+  puts "  Edit access: #{library_details.library.edit_access}"
+  
+  # Get library items from first category
+  if library_details.library.categories.any?
+    first_category_id = library_details.library.categories.first.id
+    library_items = client.get_library_items(first_library_id, first_category_id)
+    
+    puts "📚 Library Items (Category: #{library_items.category_name}):"
+    puts "  View mode: #{library_items.view_mode} | Library type: #{library_items.library_type}"
+    puts "  Items count: #{library_items.library_items.length}"
+    puts "  Can add: #{library_items.can_add}"
+  end
+end
+puts ""
+
+# Get user trackers
+trackers = client.get_trackers
+
+puts "📊 User Trackers:"
+puts "  Total trackers: #{trackers.trackers.length}"
+puts ""
+
+# Display recent trackers
+puts "📊 Recent Trackers:"
+trackers.trackers.first(3).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}"
+  puts "    Pinned: #{tracker.is_pinned} | Can share: #{tracker.can_share}"
+end
+puts ""
+
+# Get user folders
+folders = client.get_folders
+
+puts "📁 User Folders:"
+puts "  Total folders: #{folders.folders.length}"
+puts ""
+
+# Display first few folders
+puts "📁 Available Folders:"
+folders.folders.first(3).each do |folder|
+  puts "  • #{folder.name} (ID: #{folder.id})"
+  puts "    Path: #{folder.relativePath} | Child count: #{folder.child_count}"
+  puts "    Can save: #{folder.can_save} | Pinned: #{folder.is_pinned}"
+end
+puts ""
+
+# Get files from first folder with content
+if folders.folders.any?
+  folder_with_content = folders.folders.find { |f| f.child_count.to_i > 0 }
+  if folder_with_content
+    folder_files = client.get_folder_files(folder_with_content.id, include_folders: "Y")
+    puts "📁 Folder Files:"
+    puts "  Folder: #{folder_files.name} | Total: #{folder_files.total_count}"
+    puts "  Role: #{folder_files.role_name} | Upload enabled: #{folder_files.show_in_upload}"
+  end
+end
+puts ""
+
+# Get user tasks
+tasks = client.get_tasks(filter: "Pending_Tasks", page: 1, limit: 3)
+
+puts "📋 User Tasks:"
+puts "  Total tasks: #{tasks.tasks.task.length}"
+puts ""
+
+# Display first few tasks
+puts "📋 Recent Tasks:"
+tasks.tasks.task.first(3).each do |task|
+  puts "  • #{task.task_title} (ID: #{task.id})"
+  puts "    Status: #{task.status} | Assigned to: #{task.assigned_to_name}"
+  puts "    Due: #{task.due_on ? Time.at(task.due_on.to_i).strftime('%Y-%m-%d') : 'None'}"
+  puts "    Is overdue: #{task.is_overdue} | Priority: #{task.personal_priority}"
+end
+puts ""
+
+# Get detailed information for the first task
+if tasks.tasks.task.any?
+  first_task = tasks.tasks.task.first
+  task_id = first_task.is_a?(Array) ? first_task[1] : first_task.id
+  task_details = client.get_task_details(task_id)
+  
+  puts "📋 Task Details:"
+  puts "  Task: #{task_details.task.task_title} (ID: #{task_details.task.id})"
+  puts "  Status: #{task_details.task.status} | Bucket: #{task_details.task.bucket}"
+  puts "  Assigned to: #{task_details.task.assigned_to_name} | Created by: #{task_details.task.creator_name}"
+  puts "  Due: #{task_details.task.due_on ? Time.at(task_details.task.due_on.to_i).strftime('%Y-%m-%d') : 'None'}"
+  puts "  Is overdue: #{task_details.task.is_overdue} | Priority: #{task_details.task.personal_priority}"
+  puts "  Milestone: #{task_details.task.milestone_name || 'None'}"
+  puts "  Project: #{task_details.task.conversation_name}"
+  puts "  Visibility: #{task_details.task.visibility}"
+  
+  # Show reviewers
+  if task_details.task.reviewers && task_details.task.reviewers.reviewer
+    reviewers = task_details.task.reviewers.reviewer
+    puts "  Reviewers: #{reviewers.length} reviewers"
+  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
+end
+puts ""
+
+# Get user wikis
+wikis = client.get_wikis(mode: "my", limit: 5, offset: 0)
+
+puts "📚 User Wikis:"
+puts "  Total wikis: #{wikis.wikis.length}"
+puts ""
+
+# Display first few wikis
+puts "📚 Recent Wikis:"
+wikis.wikis.first(3).each do |wiki|
+  puts "  • #{wiki.title} (ID: #{wiki.id})"
+  puts "    Updated: #{Time.at(wiki.updated_at.to_i).strftime('%Y-%m-%d')}"
+  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}"
+end
+puts ""
+
+# Get detailed information for the first wiki
+if wikis.wikis.any?
+  first_wiki = wikis.wikis.first
+  wiki_details = client.get_wiki_details(first_wiki.id)
+  
+  puts "📚 Wiki Details:"
+  puts "  Wiki: #{wiki_details.wiki.details.title} (ID: #{wiki_details.wiki.details.id})"
+  puts "  Status: #{wiki_details.wiki.details.status} | Platform: #{wiki_details.wiki.details.platform}"
+  puts "  Created by: #{wiki_details.wiki.details.created_by_name} | Updated by: #{wiki_details.wiki.details.updated_by_name}"
+  puts "  Read count: #{wiki_details.wiki.details.total_read_count} | Children: #{wiki_details.wiki.details.children_count}"
+  puts "  Conversation: #{wiki_details.wiki.details.conversation_name}"
+  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 "  Archived: #{wiki_details.wiki.details.archived} | Is draft: #{wiki_details.wiki.is_draft}"
+  
+  # Show permissions
+  puts "  Permissions: Comment: #{wiki_details.wiki.can_comment}, Edit: #{wiki_details.wiki.can_edit}, Delete: #{wiki_details.wiki.can_delete}"
+  
+  # Show reactions
+  if wiki_details.wiki.reactions
+    reactions = wiki_details.wiki.reactions
+    puts "  Reactions: Like: #{reactions.like_count}, Superlike: #{reactions.superlike_count}"
+  end
+  
+  # Show comment count
+  puts "  Comment count: #{wiki_details.wiki.comment_count}"
+end
+puts ""
+
+# Get award feeds
+award_feeds = client.get_award_feeds
+
+# Display award feeds
+puts "🏆 Award Feeds:"
+puts "  Unread counts:"
+if award_feeds.unread_counts
+  puts "    Direct messages: #{award_feeds.unread_counts.direct_messages_count}"
+  puts "    What's new: #{award_feeds.unread_counts.whats_new_count}"
+  puts "    Unread feeds: #{award_feeds.unread_counts.unread_feeds_count}"
+  puts "    Mentions: #{award_feeds.unread_counts.mention_count}"
+  puts "    Primary unread: #{award_feeds.unread_counts.primary_unread_count}"
+  puts "    Secondary unread: #{award_feeds.unread_counts.secondary_unread_count}"
+  puts "    Unread notifications: #{award_feeds.unread_counts.unread_notification_count}"
+end
+puts "  Recent Award Feeds:"
+award_feeds.feeds.first(3).each do |feed|
+  puts "    • #{feed.feed_property.title if feed.feed_property} - Points: #{feed.recognition_points}"
+  puts "      From: #{feed.from_user.name if feed.from_user} | To: #{feed.to_users.length if feed.to_users} users"
+  puts "      Reactions: Like: #{feed.like_count}, Superlike: #{feed.superlike_count}"
+  puts "      Comments: #{feed.comment_count} | Created: #{Time.at(feed.created_at.to_i).strftime('%Y-%m-%d')}"
+end
+puts ""
+
+# Get core value tags
+tags = client.core_value_tags
+
+# Display core value tags
+puts "🎯 Core Value Tags:"
+tags.core_value_tags.each do |tag|
+  puts "  • #{tag.name} (ID: #{tag.id})"
+  puts "    Color: ##{tag.color}"
+end
+puts ""
+
+# Get leaderboard information
+leaderboard = client.leaderboard_info
+
+# Display leaderboard if available
+if leaderboard.leaderboard_info
+  puts "🏅 User Leaderboard:"
+  leaderboard.leaderboard_info.user_info.each do |user|
+    puts "  #{user.rank}. #{user.name} - #{user.award_count} awards"
+  end
+  puts ""
+  
+  puts "🏆 Team Leaderboard:"
+  leaderboard.leaderboard_info.team_info.each do |team|
+    puts "  #{team.rank}. #{team.name} - #{team.award_count} awards"
+  end
+else
+  puts "📊 No leaderboard data configured"
+end
+
+# Get tango gift cards information
+tango_gift_cards = client.tango_gift_cards
+
+# Display tango gift card information
+puts "🎁 Tango Gift Cards:"
+puts "  Available points: #{tango_gift_cards.tango_cards.available_points}"
+puts "  Terms: #{tango_gift_cards.tango_cards.terms[0..100]}..." if tango_gift_cards.tango_cards.terms
+puts ""
+
+# Get gift cards information
+gift_cards = client.gift_cards
+
+# Display available gift cards
+puts "🎁 Available Gift Cards:"
+gift_cards.cards.each do |card|
+  puts "  • #{card.brand_name} (Key: #{card.brand_key}) - Enabled: #{card.enabled}"
+end
+```
+
+### Error Handling with Clean Responses
+```ruby
+begin
+  user = client.me
+  
+  # Clean dot notation access
+  puts "Welcome, #{user.user_profile.minimal_profile.name}!"
+  
+rescue MangoApps::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+  # Redirect to OAuth flow
+  
+rescue MangoApps::APIError => e
+  puts "API error: #{e.message}"
+  puts "Status: #{e.status_code}"
+  
+rescue MangoApps::RateLimitError => e
+  puts "Rate limited: #{e.message}"
+  # Implement backoff strategy
+end
+```
+
+
+## Error Handling
+
+The SDK provides specific exception types for different error scenarios:
+
+```ruby
+begin
+  posts = client.posts_list
+rescue MangoApps::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue MangoApps::APIError => e
+  puts "API error: #{e.message}"
+rescue MangoApps::RateLimitError => e
+  puts "Rate limited: #{e.message}"
+end
+
+# OAuth-specific error handling
+begin
+  userinfo = client.get_userinfo
+rescue MangoApps::TokenExpiredError => e
+  puts "OAuth token expired: #{e.message}"
+  # Refresh token or redirect to OAuth flow
+rescue MangoApps::APIError => e
+  puts "OAuth userinfo error: #{e.message}"
+end
+```
+
+### Available Exception Types
+
+- `MangoApps::Error` - Base error class
+- `MangoApps::APIError` - General API errors
+- `MangoApps::AuthenticationError` - Authentication failures
+- `MangoApps::TokenExpiredError` - Token expiration
+- `MangoApps::DiscoveryError` - OAuth discovery endpoint errors
+- `MangoApps::TokenExchangeError` - OAuth token exchange errors
+- `MangoApps::BadRequestError` - 400 errors
+- `MangoApps::UnauthorizedError` - 401 errors
+- `MangoApps::ForbiddenError` - 403 errors
+- `MangoApps::NotFoundError` - 404 errors
+- `MangoApps::RateLimitError` - 429 errors
+- `MangoApps::ServerError` - 5xx errors
+
+## Configuration Options
+
+```ruby
+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",
+  timeout: 30,
+  open_timeout: 10,
+  logger: Logger.new(STDOUT)
+)
+
+# OAuth-specific configuration
+# - All OAuth endpoints automatically use HTTPS
+# - Automatic redirect handling for 301/302 responses
+# - 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)
+- ✅ **Users Module**: User profile and authentication (1 endpoint)
+- ✅ **Recognitions Module**: Award categories, get awards list, get profile awards, get team awards, get award feeds, core value tags, leaderboard info, and gift cards (8 endpoints)
+- ✅ **Notifications Module**: My priority items for requests, events, quizzes, surveys, tasks, and todos, and user notifications with unread counts (2 endpoints)
+- ✅ **Feeds Module**: User activity feeds with unread counts and feed details (1 endpoint)
+- ✅ **Posts Module**: Get all posts with filtering options and get post by ID (2 endpoints)
+- ✅ **Libraries Module**: Get user's document libraries with categories and items, get library categories by ID, and get library items by library and category ID (3 endpoints)
+- ✅ **Trackers Module**: Get user's trackers with submission dates and conversation details (1 endpoint)
+- ✅ **Attachments Module**: Get user's file folders with permissions and metadata, and get files and folders inside specific folders (2 endpoints)
+- ✅ **Tasks Module**: Get user's tasks with filtering, pagination, and detailed task information, and get detailed information for specific tasks (2 endpoints)
+- ✅ **Wikis Module**: Get user's wikis with filtering, pagination, and detailed wiki information, and get detailed information for specific wikis (2 endpoints)
+- ✅ **Error Handling**: Comprehensive error logging and testing
+- ✅ **OAuth Flow**: Token management, refresh, and userinfo endpoint
+- ✅ **Internal API Auth**: Alternative authentication using API keys
+- ✅ **Auto Detection**: Automatic authentication method detection and prioritization
+- ✅ **Pagination Support**: Optional page and limit parameters for all list APIs
+- ✅ **HTTPS Security**: Automatic HTTPS enforcement with redirect handling
+
+**Total: 29 API endpoints across 11 modules + OAuth + Internal API + Auto Detection + Pagination**
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Write real tests first (no mocking)
+4. Implement the feature
+5. Ensure all tests pass
+6. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- **Documentation**: [RubyDoc](https://rubydoc.info/gems/mangoapps-ex-sdk-ruby)
+- **Issues**: [GitHub Issues](https://github.com/MangoAppsInc/mangoapps-ex-sdk-ruby/issues)
+- **MangoApps**: [Official Website](https://www.mangoapps.com)
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.