@connectycube/use-chat

Use Chat

A React hook for state management in ConnectyCube-powered chat solutions.

This library provides a headless solution for managing chat functionality in ConnectyCube. Similar to how Formik simplifies form handling, this library streamlines the development of chat applications.

The core purpose is to handle essential chat features like state management, handling subsequent events and APIs properly etc, so the end user takes care about UI building only.

Features

• Handle chats and messages states, including the currently active conversation
• Manage chat participants states
• Maintain typing indicators and users last activity.
• Support attachments download
• Message drafts
• Moderation via user reporting and block

Installation

npm install @connectycube/use-chat

or

yarn add @connectycube/use-chat

Usage

import { useChat } from "@connectycube/use-chat";

const MyComponent = () => {
  const { connect, createChat, sendMessage, selectedDialog } = useChat();

  const handleConnect = async () => {
    const chatCredentials = {
      userId: 22,
      password: "password",
    };
    await connect(chatCredentials);
  };

  const handleCreateChat = async () => {
    const userId = 456;
    const dialog = await createChat(userId);
    await selectDialog(dialog);
  };

  const handleSendMessage = async () => {
    // send message to selected dialog
    sendMessage("Hi there");
  };

  return (
    <div className="container">
      <button type="button" onClick={handleConnect}>
        Connect
      </button>
      <button type="button" onClick={handleCreateChat}>
        Create chat
      </button>
      <button type="button" onClick={handleSendMessage}>
        Send message
      </button>
    </div>
  );
};

export default MyComponent;

For more complex example please check React chat code sample

API

Check types for more API examples https://github.com/ConnectyCube/use-chat/blob/main/src/types/index.ts

Documentation

https://developers.connectycube.com/js/use-chat

Have an issue?

Join our Discord community to get real-time help from our team

Community

• Blog
• X (twitter)@ConnectyCube
• Facebook
• Medium
• YouTube

Want to support our team:

License

Apache 2.0