{"id":37701768,"url":"https://github.com/GetStream/stream-chat-js","last_synced_at":"2026-01-23T23:00:44.785Z","repository":{"id":37493442,"uuid":"177270024","full_name":"GetStream/stream-chat-js","owner":"GetStream","description":"JS / Browser Client - Build Chat with GetStream.io","archived":false,"fork":false,"pushed_at":"2026-01-20T13:05:51.000Z","size":7233,"stargazers_count":205,"open_issues_count":44,"forks_count":78,"subscribers_count":37,"default_branch":"master","last_synced_at":"2026-01-20T19:38:25.884Z","etag":null,"topics":["chat","chat-api","chat-sdk","chat-sdk-js"],"latest_commit_sha":null,"homepage":"https://getstream.io/chat/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GetStream.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2019-03-23T09:32:59.000Z","updated_at":"2026-01-20T13:05:54.000Z","dependencies_parsed_at":"2023-10-03T17:58:44.798Z","dependency_job_id":"f87bbc77-264c-4a6a-919e-bf39c29264fb","html_url":"https://github.com/GetStream/stream-chat-js","commit_stats":{"total_commits":1554,"total_committers":79,"mean_commits":"19.670886075949365","dds":0.8629343629343629,"last_synced_commit":"c477fef26ba7b109e8206ac46c186105ba7462f6"},"previous_names":[],"tags_count":361,"template":false,"template_full_name":null,"purl":"pkg:github/GetStream/stream-chat-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GetStream%2Fstream-chat-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GetStream%2Fstream-chat-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GetStream%2Fstream-chat-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GetStream%2Fstream-chat-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GetStream","download_url":"https://codeload.github.com/GetStream/stream-chat-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GetStream%2Fstream-chat-js/sbom","scorecard":{"id":56084,"data":{"date":"2025-08-11","repo":{"name":"github.com/GetStream/stream-chat-js","commit":"15e54077e8091ca7154e58a824528e94a7f5d7de"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Code-Review","score":6,"reason":"Found 18/30 approved changesets -- score normalized to 6","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Dangerous-Workflow","score":0,"reason":"dangerous workflow patterns detected","details":["Warn: script injection with untrusted input ' github.event.pull_request.title ': .github/workflows/pr-check.yml:16"],"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/lint.yml:1","Warn: no topLevel permission defined: .github/workflows/pr-check.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Warn: no topLevel permission defined: .github/workflows/scheduled_test.yml:1","Warn: no topLevel permission defined: .github/workflows/size.yml:1","Warn: no topLevel permission defined: .github/workflows/type.yml:1","Warn: no topLevel permission defined: .github/workflows/unit.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/lint.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr-check.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/pr-check.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scheduled_test.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/scheduled_test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/scheduled_test.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/scheduled_test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/size.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/size.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/size.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/size.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/type.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/type.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/unit.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/GetStream/stream-chat-js/unit.yml/master?enable=pin","Info:   0 out of   7 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 18 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"15 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-xffm-g5w8-qvg7","Warn: Project is vulnerable to: GHSA-8hc4-vh64-cxmj","Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc","Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-95jq-xph2-cx9h","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-x574-m823-4x7w","Warn: Project is vulnerable to: GHSA-4r4m-qw57-chr8","Warn: Project is vulnerable to: GHSA-xcj6-pq6g-qj4x","Warn: Project is vulnerable to: GHSA-356w-63v5-8wf4","Warn: Project is vulnerable to: GHSA-859w-5945-r5v3"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-15T00:47:04.104Z","repository_id":37493442,"created_at":"2025-08-15T00:47:04.105Z","updated_at":"2025-08-15T00:47:04.105Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28702892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","chat-api","chat-sdk","chat-sdk-js"],"created_at":"2026-01-16T13:00:26.529Z","updated_at":"2026-01-23T23:00:44.778Z","avatar_url":"https://github.com/GetStream.png","language":"TypeScript","readme":"# Official JavaScript SDK for [Stream Chat](https://getstream.io/chat/)\n\n[![NPM](https://img.shields.io/npm/v/stream-chat.svg)](https://www.npmjs.com/package/stream-chat)\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./assets/logo.svg\" width=\"50%\" height=\"50%\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    Official JavaScript API client for Stream Chat, a service for building chat applications.\n    \u003cbr /\u003e\n    \u003ca href=\"https://getstream.io/chat/docs/\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/GetStream/stream-chat-js/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/GetStream/stream-chat-js/issues\"\u003eRequest Feature\u003c/a\u003e\n\u003c/p\u003e\n\n## 📝 About Stream\n\nYou can sign up for a Stream account at our [Get Started](https://getstream.io/chat/get_started/) page.\n\nThis 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](https://github.com/GetStream/stream-chat-flutter), [React](https://github.com/GetStream/stream-chat-react) and [Angular](https://github.com/GetStream/stream-chat-angular) SDKs. For more information, check out our [documentation](https://getstream.io/chat/docs/).\n\n## ⚙️ Installation\n\n### NPM\n\n```bash\nnpm install stream-chat\n```\n\n### Yarn\n\n```bash\nyarn add stream-chat\n```\n\n## ✨ Getting Started\n\n```ts\nimport { StreamChat } from 'stream-chat';\n// or if you are using CommonJS\nconst { StreamChat } = require('stream-chat');\n\nconst client = new StreamChat('API_KEY', 'API_SECRET', {\n  disableCache: true, // recommended option for server-side use\n  // ...other options like `baseURL`...\n});\n\n// create a user\nawait client.upsertUser({\n  id: 'vishal-1',\n  name: 'Vishal',\n});\n\n// create a channel\nconst channel = client.channel('messaging', 'test-channel', {\n  created_by_id: 'vishal-1',\n});\nawait channel.create();\n\n// send message\nconst { message } = await channel.sendMessage({ text: 'This is a test message' });\n\n// send reaction\nawait channel.sendReaction(message.id, { type: 'love', user: { id: 'vishal-1' } });\n```\n\nThe `StreamChat` client is set up to allow extension of the base types through use of module augmentation, custom types will carry through to all client returns and provide code-completion to queries (if supported). To extend Stream's entities with custom data you'll have to create a declaration file and make sure it's loaded by TypeScript, [see the list of extendable interfaces](https://github.com/GetStream/stream-chat-js/blob/master/src/custom_types.ts) and the example bellow using two of the most common ones:\n\n```ts\n// stream-custom-data.d.ts\n\nimport 'stream-chat';\n\ndeclare module 'stream-chat' {\n  interface CustomMessageData {\n    custom_property?: number;\n  }\n  interface CustomUserData {\n    profile_picture?: string;\n  }\n}\n\n// index.ts\n\n// property `profile_picture` is code-completed and expects type `string | undefined`\nawait client.partialUpdateUser({\n  id: 'vishal-1',\n  set: { profile_picture: 'https://random.picture/1.jpg' },\n});\n\n// property `custom_property` is code-completed and expects type `number | undefined`\nconst { message } = await channel.sendMessage({\n  text: 'This is another test message',\n  custom_property: 255,\n});\n\nmessage.custom_property; // in the response object as well\n```\n\n\u003e [!WARNING]  \n\u003e Generics mechanism has been removed in version `9.0.0` in favour of the module augmentation, please see [the release guide](https://getstream.io/chat/docs/node/upgrade-stream-chat-to-v9) on how to migrate.\n\n## 🔗 (Optional) Development Setup in Combination With Our SDKs\n\n### Connect to [Stream Chat React Native SDK](https://github.com/GetStream/stream-chat-react-native)\n\nRun in the root of this repository:\n\n```sh\nyarn link\n```\n\nRun in the root of one of the example applications (SampleApp/TypeScriptMessaging) in the `stream-chat-react-native` repository:\n\n```sh\nyarn link stream-chat\nyarn start\n```\n\nOpen `metro.config.js` file and set value for `watchFolders` as:\n\n```js\nconst streamChatRoot = '\u003cPATH TO YOUR PROJECT\u003e/stream-chat-js'\n\nmodule.exports = {\n  // the rest of the metro configuration goes here\n  ...\n  watchFolders: [projectRoot].concat(alternateRoots).concat([streamChatRoot]),\n  resolver: {\n    // the other resolver configurations go here\n    ...\n    extraNodeModules: {\n      // the other extra node modules go here\n      ...\n      'stream-chat': streamChatRoot\n    }\n  }\n};\n```\n\nMake sure to replace `\u003cPATH TO YOUR PROJECT\u003e` with the correct path for the `stream-chat-js` folder as per your directory structure.\n\nRun in the root of this repository:\n\n```sh\nyarn start\n```\n\n## 📚 More Code Examples\n\nRead up more on [Logging](./docs/logging.md) and [User Token](./docs/userToken.md) or visit our [documentation](https://getstream.io/chat/docs/) for more examples.\n\n## ✍️ Contributing\n\nWe 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)](https://docs.google.com/forms/d/e/1FAIpQLScFKsKkAJI7mhCr7K9rEIOpqIDThrWxuvxnwUq2XkHyG154vQ/viewform) first. See our [license file](./LICENSE) for more details.\n\nHead over to [CONTRIBUTING.md](./CONTRIBUTING.md) for some development tips.\n\n## 🧑‍💻 We Are Hiring!\n\nWe've recently closed a [$38 million Series B funding round](https://techcrunch.com/2021/03/04/stream-raises-38m-as-its-chat-and-activity-feed-apis-power-communications-for-1b-users/) and we keep actively growing.\nOur 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.\n\nCheck out our current openings and apply via [Stream's website](https://getstream.io/team/#jobs).\n","funding_links":[],"categories":["Official SDKs \u0026 Tutorials"],"sub_categories":["Web \u0026 JavaScript"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGetStream%2Fstream-chat-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGetStream%2Fstream-chat-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGetStream%2Fstream-chat-js/lists"}