Real-time Events

Overview

social.plus SDK provides a powerful real-time event system that keeps your application synchronized with live data changes. When users modify profiles, create posts, send messages, or perform other actions, these changes are instantly reflected across all connected devices.

Real-time events work seamlessly with Live Objects & Collections to provide automatic UI updates without manual data fetching.

Supported Data Models

Social Features

Communities, Posts, Comments, User profiles, Follow relationships

Chat Features

Channels, Subchannels, Messages, Member activities

Event Types by Model

Model	Available Events
Community	Created, Updated, Deleted, Joined, Left, Member management
Post	Created, Updated, Deleted, Approved, Flagged, Reactions
Comment	Created, Updated, Deleted, Flagged, Reactions
User	Profile updates, Follow/Unfollow activities
Channel	Messages, Member activities, Status changes
Subchannel	Thread-specific updates

How It Works

1. Subscription Topics

Create subscription topics to define which events you want to receive:

2. Event Delivery

Events are delivered through Live Objects and Collections that you’re already observing:

Automatic Updates: No manual refresh needed
Real-time Synchronization: Changes appear instantly
Efficient: Only subscribed events are processed

Managing Subscriptions

Subscription Limits

The SDK has a maximum limit of 20 active subscriptions per session. Manage your subscriptions carefully to stay within this limit.

Best Practices for Subscription Management

Use Higher-Level Topics

Instead of subscribing to individual posts or comments, subscribe to community-level topics with POST_AND_COMMENT level to cover all content in that community.

// ✅ Better: One subscription covers all posts and comments
const topic = getCommunityTopic(community, SubscriptionLevels.POST_AND_COMMENT);

// ❌ Avoid: Multiple subscriptions for the same data
const postTopic = getPostTopic(post1, SubscriptionLevels.POST);
const commentTopic = getPostTopic(post1, SubscriptionLevels.COMMENT);

Subscribe on Render, Unsubscribe on Leave

Manage subscriptions based on UI state to optimize performance and stay within limits.

// React example
useEffect(() => {
  const topic = getCommunityTopic(community, SubscriptionLevels.POST);
  
  // Subscribe when component mounts
  EventSubscriberRepository.subscribe(topic);
  
  return () => {
    // Unsubscribe when component unmounts
    EventSubscriberRepository.unsubscribe(topic);
  };
}, [community.communityId]);

Automatic Cleanup on Logout

Next Steps

Social Real-time Events

Explore social platform event subscriptions

Chat Real-time Events

Learn about chat and messaging events

Powered by

Getting Started

Fundamentals

Social

Chat

Overview

Supported Data Models

Social Features

Chat Features

Event Types by Model

How It Works

1. Subscription Topics

2. Event Delivery

Managing Subscriptions

Subscription Limits

Best Practices for Subscription Management

Next Steps

Social Real-time Events

Chat Real-time Events

Powered by

Getting Started

Fundamentals

Social

Chat

​Overview

​Supported Data Models

Social Features

Chat Features

​Event Types by Model

​How It Works

​1. Subscription Topics

​2. Event Delivery

​Managing Subscriptions

​Subscription Limits

​Best Practices for Subscription Management

​Next Steps

Social Real-time Events

Chat Real-time Events

Overview

Supported Data Models

Event Types by Model

How It Works

1. Subscription Topics

2. Event Delivery

Managing Subscriptions

Subscription Limits

Best Practices for Subscription Management

Next Steps