545563e776
- Complete NestJS TypeScript implementation with WebSocket support - Direct messaging (DM) and group chat functionality - End-to-end encryption with AES encryption and key pairs - Media file support (images, videos, audio, documents) up to 100MB - Push notifications with Firebase Cloud Messaging integration - Mention alerts and real-time typing indicators - User authentication with JWT and Passport - SQLite database with TypeORM entities and relationships - Comprehensive API documentation with Swagger/OpenAPI - File upload handling with secure access control - Online/offline status tracking and presence management - Message editing, deletion, and reply functionality - Notification management with automatic cleanup - Health check endpoint for monitoring - CORS configuration for cross-origin requests - Environment-based configuration management - Structured for Flutter SDK integration Features implemented: ✅ Real-time messaging with Socket.IO ✅ User registration and authentication ✅ Direct messages and group chats ✅ Media file uploads and management ✅ End-to-end encryption ✅ Push notifications ✅ Mention alerts ✅ Typing indicators ✅ Message read receipts ✅ Online status tracking ✅ File access control ✅ Comprehensive API documentation Ready for Flutter SDK development and production deployment.
82 lines
2.3 KiB
Markdown
82 lines
2.3 KiB
Markdown
|
|
# socket.io-parser
|
|
|
|
[](https://github.com/socketio/socket.io-parser/actions)
|
|
[](http://badge.fury.io/js/socket.io-parser)
|
|
|
|
A socket.io encoder and decoder written in JavaScript complying with version `5`
|
|
of [socket.io-protocol](https://github.com/socketio/socket.io-protocol).
|
|
Used by [socket.io](https://github.com/automattic/socket.io) and
|
|
[socket.io-client](https://github.com/automattic/socket.io-client).
|
|
|
|
Compatibility table:
|
|
|
|
| Parser version | Socket.IO server version | Protocol revision |
|
|
|----------------| ------------------------ | ----------------- |
|
|
| 3.x | 1.x / 2.x | 4 |
|
|
| 4.x | 3.x | 5 |
|
|
|
|
|
|
## Parser API
|
|
|
|
socket.io-parser is the reference implementation of socket.io-protocol. Read
|
|
the full API here:
|
|
[socket.io-protocol](https://github.com/learnboost/socket.io-protocol).
|
|
|
|
## Example Usage
|
|
|
|
### Encoding and decoding a packet
|
|
|
|
```js
|
|
var parser = require('socket.io-parser');
|
|
var encoder = new parser.Encoder();
|
|
var packet = {
|
|
type: parser.EVENT,
|
|
data: 'test-packet',
|
|
id: 13
|
|
};
|
|
encoder.encode(packet, function(encodedPackets) {
|
|
var decoder = new parser.Decoder();
|
|
decoder.on('decoded', function(decodedPacket) {
|
|
// decodedPacket.type == parser.EVENT
|
|
// decodedPacket.data == 'test-packet'
|
|
// decodedPacket.id == 13
|
|
});
|
|
|
|
for (var i = 0; i < encodedPackets.length; i++) {
|
|
decoder.add(encodedPackets[i]);
|
|
}
|
|
});
|
|
```
|
|
|
|
### Encoding and decoding a packet with binary data
|
|
|
|
```js
|
|
var parser = require('socket.io-parser');
|
|
var encoder = new parser.Encoder();
|
|
var packet = {
|
|
type: parser.BINARY_EVENT,
|
|
data: {i: new Buffer(1234), j: new Blob([new ArrayBuffer(2)])},
|
|
id: 15
|
|
};
|
|
encoder.encode(packet, function(encodedPackets) {
|
|
var decoder = new parser.Decoder();
|
|
decoder.on('decoded', function(decodedPacket) {
|
|
// decodedPacket.type == parser.BINARY_EVENT
|
|
// Buffer.isBuffer(decodedPacket.data.i) == true
|
|
// Buffer.isBuffer(decodedPacket.data.j) == true
|
|
// decodedPacket.id == 15
|
|
});
|
|
|
|
for (var i = 0; i < encodedPackets.length; i++) {
|
|
decoder.add(encodedPackets[i]);
|
|
}
|
|
});
|
|
```
|
|
See the test suite for more examples of how socket.io-parser is used.
|
|
|
|
|
|
## License
|
|
|
|
MIT
|