![Namecheap Takes Down Polyfill.io Service Following Supply Chain Attack](https://cdn.sanity.io/images/cgdhsj6q/production/6af25114feaaac7179b18127c83327568ff592d1-1024x1024.webp?w=800&fit=max&auto=format)
Security News
Namecheap Takes Down Polyfill.io Service Following Supply Chain Attack
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
stream-chat
Advanced tools
Readme
Official JavaScript API client for Stream Chat, a service for building chat applications.
Explore the docs ยป
Report Bug
ยท
Request Feature
You can sign up for a Stream account at our Get Started page.
This library can be used by both frontend and backend applications. For frontend, we have frameworks that are based on this library such as the Flutter, React and Angular SDKs. For more information, check out our docs.
npm install stream-chat
yarn add stream-chat
<script src="https://cdn.jsdelivr.net/npm/stream-chat"></script>
The StreamChat client is setup to allow extension of the base types through use of generics when instantiated. The default instantiation has all generics set to Record<string, unknown>
.
import { StreamChat } from 'stream-chat';
// Or if you are on commonjs
const StreamChat = require('stream-chat').StreamChat;
const client = StreamChat.getInstance('YOUR_API_KEY', 'API_KEY_SECRET');
const channel = client.channel('messaging', 'TestChannel');
await channel.create();
Or you can customize the generics:
type ChatChannel = { image: string; category?: string };
type ChatUser1 = { nickname: string; age: number; admin?: boolean };
type ChatUser2 = { nickname: string; avatar?: string };
type UserMessage = { country?: string };
type AdminMessage = { priorityLevel: number };
type ChatAttachment = { originalURL?: string };
type CustomReaction = { size?: number };
type ChatEvent = { quitChannel?: boolean };
type CustomCommands = 'giphy';
type StreamType = {
attachmentType: ChatAttachment;
channelType: ChatChannel;
commandType: CustomCommands;
eventType: ChatEvent;
messageType: UserMessage | AdminMessage;
reactionType: CustomReaction;
userType: ChatUser1 | ChatUser2;
};
const client = StreamChat.getInstance<StreamType>('YOUR_API_KEY', 'API_KEY_SECRET');
// Create channel
const channel = client.channel('messaging', 'TestChannel');
await channel.create();
// Create user
await client.upsertUser({
id: 'vishal-1',
name: 'Vishal',
});
// Send message
const { message } = await channel.sendMessage({ text: `Test message` });
// Send reaction
await channel.sendReaction(message.id, { type: 'love', user: { id: 'vishal-1' } });
Custom types provided when initializing the client will carry through to all client returns and provide intellisense to queries.
Run in the root of this repo
yarn link
Run in the root of one of the example apps (SampleApp/TypeScriptMessaging) in the stream-chat-react-native
repo
yarn link stream-chat
yarn start
Open metro.config.js
file and set value for watchFolders as
module.exports = {
...
watchFolders: [projectRoot].concat(alternateRoots).concat(['{{CHANGE_TO_THE_PATH_TO_YOUR_PROJECT}}/stream-chat-js'])
};
Make sure to replace {{CHANGE_TO_THE_PATH_TO_YOUR_PROJECT}}
with the correct path for stream-chat-js folder as per your directory structure
Run in the root of this repo
yarn start
Head over to docs/typescript.md for more examples.
We welcome code changes that improve this library or fix a problem, please make sure to follow all best practices and add tests if applicable before submitting a Pull Request on Github. We are very happy to merge your code in the official repository. Make sure to sign our Contributor License Agreement (CLA) first. See our license file for more details.
Head over to CONTRIBUTING.md for some development tips.
We've recently closed a $38 million Series B funding round and we keep actively growing. Our APIs are used by more than a billion end-users, and you'll have a chance to make a huge impact on the product within a team of the strongest engineers all over the world.
Check out our current openings and apply via Stream's website.
FAQs
JS SDK for the Stream Chat API
The npm package stream-chat receives a total of 118,559 weekly downloads. As such, stream-chat popularity was classified as popular.
We found that stream-chat demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.ย It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.
Security News
A JavaScript library maintainer is under fire after merging a controversial PR to support legacy versions of Node.js.