A simple realtime chat SDK for web and mobile apps using socket.io with support for end-to-end encryption and multi-tenant backend integration.
npm install e2ee-chatThis SDK allows you to easily integrate end-to-end encrypted 1-to-1 realtime chat into your app using our hosted microservice.
---
- 🔒 End-to-end AES encrypted messages
- ⚡️ Socket-based realtime messaging
- 🧩 Multi-tenant DB support via apiKey
- 👥 Role-based user handling (client, handler, admin)
- 📥 Chat history via REST API
- 🔄 Dynamic handler takeover logic
- ✅ Works with Node.js, React.js, Next.js (App Router compatible)
---
``bash`
npm install e2ee-chat
---
`jsx
"use client";
import React, { useState } from "react";
import useChat from "e2ee-chat/useChat";
export default function ChatBox() {
const [input, setInput] = useState("");
const { messages, sendMessage, joined } = useChat({
serverUrl: "http://localhost:4000",
roomId: "session_abc123",
userId: "user1",
userType: "client",
secretKey: "shared-secret-123",
apiKey: "your-api-key-here",
});
return (
---
🧩 useChat Options
| Option | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------------- |
|
| string | ✅ | Your hosted chat server URL |
| roomId | string | ✅ | Session ID for the chat |
| userId | string | ✅ | Your current user's ID |
| userType | string | ✅ | client, handler, or admin |
| secretKey | string | ✅ | AES secret used to encrypt/decrypt |
| apiKey | string | ✅ | API key to identify your org DB |---
📥 Accessing Chat History
Chat history is fetched automatically when the user joins. All messages are decrypted with your
secretKey.---
🔁 Admin Takeover Logic
You can trigger handler takeover:
`js
const { takeover } = useChat(...);
takeover(); // Makes current user the new handler
`---
🏗 Works in:
- ✅ React.js
- ✅ Next.js App Router
- ✅ Node.js test scripts
---
📁 Server Setup (Hosted Microservice)
To host your own server, clone chat-server and set up
:`env
PORT=4000
MONGO_URI=your-default-db-uri
`---
🧠 Multi-Tenant Support
Register your
and mongoUri in the Tenant` collection to isolate DB access per organization.---
For issues, contact: support@yourchatservice.com
---
MIT