feeds-v3 collections update

Author: itsmeadi

FEEDS_INTEGRATION_TESTS.md

@@ -0,0 +1,162 @@
+# Feeds Integration Tests
+
+This document describes the comprehensive integration tests for the GetStream Go SDK Feeds API.
+
+## Overview
+
+The integration tests in `feeds_integration_test.go` provide comprehensive coverage of all Feeds API functionality, following the same patterns as the PHP SDK integration tests. These tests demonstrate real-world usage patterns and serve as both validation and documentation.
+
+## Test Structure
+
+The tests are organized in a logical flow with **36 comprehensive test scenarios**:
+
+1. **Environment Setup** - User and feed creation
+2. **Activity Operations** - Create, read, update, delete activities
+3. **Reaction Operations** - Add, query, delete reactions
+4. **Comment Operations** - Add, read, update, delete comments
+5. **Bookmark Operations** - Add, query, update, delete bookmarks
+6. **Follow Operations** - Follow, query, unfollow users
+7. **Batch Operations** - Bulk activity operations
+8. **Advanced Operations** - Polls, pins, moderation
+9. **Error Handling** - Testing various error scenarios
+10. **Real-world Usage** - Comprehensive usage demonstration
+11. **Feed Group CRUD** - Complete feed group lifecycle management
+12. **Feed View CRUD** - Custom feed view creation and management
+13. **Feed Management** - Individual feed operations and querying
+14. **Batch Operations** - Bulk feed creation and management
+
+## Running the Tests
+
+### Prerequisites
+
+1. Set up environment variables for Stream credentials:
+   ```bash
+   export STREAM_KEY="your-stream-api-key"
+   export STREAM_SECRET="your-stream-api-secret"
+   ```
+
+2. Or create a `.env` file in the project root:
+   ```
+   STREAM_KEY=your-stream-api-key
+   STREAM_SECRET=your-stream-api-secret
+   ```
+
+### Running All Integration Tests
+
+```bash
+# Run all integration tests
+go test -v -run TestFeedIntegrationSuite
+
+# Run with race detection
+go test -v -race -run TestFeedIntegrationSuite
+
+# Skip integration tests in short mode
+go test -short ./...
+```
+
+### Running Individual Test Categories
+
+```bash
+# Run specific test categories
+go test -v -run TestFeedIntegrationSuite/Test02_CreateActivity
+go test -v -run TestFeedIntegrationSuite/Test08_AddComment
+go test -v -run TestFeedIntegrationSuite/Test32_RealWorldUsageDemo
+```
+
+## Code Snippets
+
+The tests include comprehensive code snippets marked with `// snippet-start:` and `// snippet-end:` comments. These snippets demonstrate:
+
+### Basic Activity Operations
+- `AddActivity` - Creating activities with various content types
+- `QueryActivities` - Querying activities with filters
+- `GetActivity` - Retrieving single activities
+- `UpdateActivity` - Updating activity content
+- `DeleteActivity` - Soft and hard deletion
+
+### Advanced Features
+- `AddActivityWithImageAttachment` - Activities with media
+- `AddVideoActivity` - Video content activities
+- `AddStoryActivityWithExpiration` - Temporary content
+- `AddActivityToMultipleFeeds` - Cross-posting
+
+### Reactions and Comments
+- `AddReaction` - Adding reactions to activities
+- `QueryActivityReactions` - Querying reactions
+- `AddComment` - Adding comments to activities
+- `QueryComments` - Querying comments with filters
+
+### Social Features
+- `Follow` / `Unfollow` - User following
+- `AddBookmark` - Bookmarking content
+- `CreatePoll` / `VotePoll` - Poll functionality
+
+### Feed Group & View Management
+- `ListFeedGroups` / `CreateFeedGroup` - Feed group management
+- `GetFeedGroup` / `UpdateFeedGroup` / `DeleteFeedGroup` - Feed group CRUD
+- `ListFeedViews` / `CreateFeedView` - Feed view management
+- `GetFeedView` / `UpdateFeedView` / `DeleteFeedView` - Feed view CRUD
+- `CreateFeedsBatch` - Bulk feed creation
+- `QueryFeeds` - Feed querying with filters
+
+### Error Handling
+- `HandleInvalidActivityId` - Invalid ID handling
+- `HandleEmptyActivityText` - Validation errors
+- `HandleInvalidUserId` - Authentication errors
+
+## Test Features
+
+### Automatic Cleanup
+- All created resources are automatically cleaned up after tests
+- Uses hard deletion to ensure clean test environment
+- Tracks created activities, comments, and other resources
+
+### Error Handling
+- Tests both success and failure scenarios
+- Demonstrates proper error handling patterns
+- Includes authentication and authorization testing
+
+### Real-world Patterns
+- Comprehensive usage demonstration
+- Multi-step workflows (post → react → comment → bookmark)
+- Pagination and filtering examples
+
+### Documentation
+- Each test includes descriptive output
+- Code snippets are clearly marked for documentation extraction
+- Follows the same patterns as other SDK integration tests
+
+## Test Data
+
+The tests use:
+- Unique user IDs generated with UUIDs
+- Temporary test data that doesn't affect production
+- Automatic cleanup to prevent data accumulation
+- Realistic test scenarios (coffee shop posts, polls, etc.)
+
+## Notes
+
+- Tests are designed to run against a real Stream API instance
+- Some features may be skipped if not available in your Stream plan
+- Tests include comprehensive logging for debugging
+- All tests are independent and can run in any order
+- Resource cleanup ensures tests don't interfere with each other
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Authentication Errors**: Ensure STREAM_KEY and STREAM_SECRET are set correctly
+2. **Feature Not Available**: Some tests may be skipped if features aren't enabled in your Stream plan
+3. **Rate Limiting**: Tests include appropriate delays and error handling for rate limits
+4. **Network Issues**: Tests include retry logic and proper error handling
+
+### Debug Mode
+
+Run tests with verbose output to see detailed execution:
+
+```bash
+go test -v -run TestFeedIntegrationSuite 2>&1 | tee test_output.log
+```
+
+This will show all test output including the emoji-decorated progress indicators and detailed operation logs.

call.go

@@ -1289,8 +1289,8 @@ func test26ModerateActivity(t *testing.T, ctx context.Context, feedsClient *gets
 
 	// snippet-start: ModerateActivity
 	moderationResponse, err := feedsClient.ActivityFeedback(ctx, activityID, &getstream.ActivityFeedbackRequest{
-		//Report: getstream.PtrTo(true),
-		//Reason: getstream.PtrTo("inappropriate_content"),
+		// Report: getstream.PtrTo(true),
+		// Reason: getstream.PtrTo("inappropriate_content"),
 		UserID: &testUserID2, // Different user reporting
 	})
 	// snippet-end: ModerateActivity