# TopicsController
## Overview
`TopicsController` is a utility class for managing topic-based subscriptions in real-time applications. It handles subscribing to topics, listening for specific events, and managing subscription lifecycles.

## API Reference
### Constructor
```javascript
const topicsController = new TopicsController(client);
```

| Parameter | Type | Description |
|-----------|------|-------------|
| client | Object | RTEngine client |

### Properties

| Property | Type | Description |
|----------|------|-------------|
| subscribed | Set | Stores currently subscribed topics |

### Methods

#### on(topic, event, callback)

Registers a callback for a specific event on a given topic.

```javascript
topicsController.on('chat/room1', 'message', (data, payload) => {
  console.log('Message received:', data);
});
```

| Parameter | Type | Description |
|-----------|------|-------------|
| topic | string | Topic to associate the event with |
| event | string | Name of the event to listen for |
| callback | Function | Function to execute when the event occurs on the topic |

#### subscribe(topic)

Subscribes to a specific topic.

```javascript
await topicsController.subscribe('chat/room1');
```

| Parameter | Type | Description |
|-----------|------|-------------|
| topic | string | Topic to subscribe to |
| Returns | Promise<boolean> | Resolves to true when subscription is complete |

#### unsubscribe(topic)

Unsubscribes from a specific topic.

```javascript
await topicsController.unsubscribe('chat/room1');
```

| Parameter | Type | Description |
|-----------|------|-------------|
| topic | string | Topic to unsubscribe from |
| Returns | Promise<boolean> | Resolves to true when unsubscription is complete |

#### unsubscribeAll()

Unsubscribes from all currently subscribed topics.

```javascript
await topicsController.unsubscribeAll();
```

| Returns | Promise<boolean> | Resolves to true when all unsubscriptions are complete |

#### regenerate()

Refreshes all current subscriptions by unsubscribing and resubscribing.

```javascript
await topicsController.regenerate();
```

| Returns | Promise<boolean> | Resolves to true when regeneration is complete |

## Basic Usage Example

```javascript
// Initialize
const topicsController = new TopicsController(realTimeClient);

// Subscribe to a topic
await topicsController.subscribe('notifications');

// Listen for events on that topic
topicsController.on('notifications', 'new', handleNewNotification);

// Clean up when done
await topicsController.unsubscribe('notifications');
// Or unsubscribe from everything
await topicsController.unsubscribeAll();
```