mirror of
https://github.com/ragestudio/linebridge.git
synced 2025-06-09 10:34:17 +00:00
102 lines
2.6 KiB
Markdown
102 lines
2.6 KiB
Markdown
# 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()
|
|
```
|