{"id":13767542,"url":"https://github.com/nicdex/node-eventstore-client","last_synced_at":"2026-01-20T14:31:31.364Z","repository":{"id":57311329,"uuid":"53527070","full_name":"nicdex/node-eventstore-client","owner":"nicdex","description":"Node client library for EventStore using TCP","archived":false,"fork":false,"pushed_at":"2024-11-18T20:46:59.000Z","size":1228,"stargazers_count":91,"open_issues_count":10,"forks_count":32,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-11-24T02:06:58.260Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicdex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-03-09T19:52:01.000Z","updated_at":"2024-11-18T20:47:04.000Z","dependencies_parsed_at":"2024-06-18T14:00:10.135Z","dependency_job_id":"efa50c12-5d0a-4a8c-a619-0faac114d56f","html_url":"https://github.com/nicdex/node-eventstore-client","commit_stats":{"total_commits":164,"total_committers":20,"mean_commits":8.2,"dds":0.7073170731707317,"last_synced_commit":"80f2e7e50f1a48c6a9bd6b81cdb6b90bd9b340e9"},"previous_names":["nicdex/eventstore-node"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/nicdex/node-eventstore-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicdex%2Fnode-eventstore-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicdex%2Fnode-eventstore-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicdex%2Fnode-eventstore-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicdex%2Fnode-eventstore-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicdex","download_url":"https://codeload.github.com/nicdex/node-eventstore-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicdex%2Fnode-eventstore-client/sbom","scorecard":{"id":684340,"data":{"date":"2025-08-11","repo":{"name":"github.com/nicdex/node-eventstore-client","commit":"40029ab81b6be17d801c7c01a8fcc99c45a79843"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"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":"Code-Review","score":1,"reason":"Found 4/21 approved changesets -- score normalized to 1","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":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"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":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"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":"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: npmCommand not pinned by hash: build-and-test.sh:9","Info:   0 out of   1 npmCommand 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":"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":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"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":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"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":"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":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 13 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":"Vulnerabilities","score":0,"reason":"10 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-h6ch-v84p-w6p9","Warn: Project is vulnerable to: GHSA-phwq-j96m-2c2q","Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3"],"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-22T00:15:50.929Z","repository_id":57311329,"created_at":"2025-08-22T00:15:50.929Z","updated_at":"2025-08-22T00:15:50.929Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28604848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"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":[],"created_at":"2024-08-03T16:01:09.580Z","updated_at":"2026-01-20T14:31:31.339Z","avatar_url":"https://github.com/nicdex.png","language":"JavaScript","funding_links":[],"categories":["Clients by language","JavaScript"],"sub_categories":["JavaScript"],"readme":"# node-eventstore-client\nA port of the EventStore .Net ClientAPI to Node.js\n\n## Learning\n\nIf you want to learn more about EventSourcing/EventModeling, you can join one of the monthly virtual workshops offered by my employer Adaptech Group, see info at [https://adaptechgroup.com/#workshop](https://adaptechgroup.com/#workshop).\n\n## Status\n\n### Missing features:\n\n- Set system settings\n\n### Areas to improve\n\n- Errors\n  - Use codes or types to differentiate between errors\n- Performance\n  - Performance hasn't been tested yet\n- Tests\n  - Can always do with more tests\n\n## Getting started\n\nInstall using `npm install node-eventstore-client`\n\nVersions to install to match EventStore versions:\n\n- 0.1.x for ES prior to 3.9.4\n- 0.2.x for ES from 3.9.4 to 5.x\n- 20.10.x for ES 20.10 LTS\n- 21.10.x for ES 21.10 LTS\n- 22.10.x for ES 22.10 LTS\n\n### Dependencies\n\n- Node.js \u003e= 14\n- Modules: [long](https://www.npmjs.org/package/long), [protobufjs](https://www.npmjs.org/package/protobufjs), [uuid](https://www.npmjs.org/package/uuid), [strict-event-emitter-types](https://www.npmjs.com/package/strict-event-emitter-types) (installed via `npm install`)\n\n### Install and run an Eventstore on localhost\n\nSee https://eventstore.com\n\n*Note: If you are using a version of EventStore prior to 3.9.4, you need to use version 0.1.x of this package `npm install node-eventstore-client@^0.1`.*  \n\n\n### API Documentation\n\n#### Offline\n\nThe offline documentation can be found in the module folder `./node_modules/node-eventstore-client/docs`.\n\n#### Online\n\nThe online documentation can be found at [https://dev.nicdex.com/node-eventstore-client/docs/](https://dev.nicdex.com/node-eventstore-client/docs/)\n  \n### Example: Storing an event\n\nSave to ```app.js:```\n\n```javascript\nvar esClient = require('node-eventstore-client');\nvar uuid = require('uuid');\n\nvar streamName = \"testStream\";\n/* \n  Connecting to a single node using \"tcp://localhost:1113\"\n  - to connect to a cluster via dns discovery use \"discover://my.host:2113\"\n  - to connect to a cluster via gossip seeds use \n  [\n    new esClient.GossipSeed({host: '192.168.1.10', port: 2113}), \n    new esClient.GossipSeed({host: '192.168.1.11', port: 2113}), \n    new esClient.GossipSeed({host: '192.168.1.12', port: 2113})\n  ]\n*/\nvar connSettings = {};  // Use defaults\nvar esConnection = esClient.createConnection(connSettings, \"tcp://localhost:1113\");\nesConnection.connect();\nesConnection.once('connected', function (tcpEndPoint) {\n    console.log('Connected to eventstore at ' + tcpEndPoint.host + \":\" + tcpEndPoint.port);\n});\n\nvar eventId = uuid.v4();\nvar eventData = {\n    a : Math.random(), \n    b: uuid.v4()\n};\nvar event = esClient.createJsonEventData(eventId, eventData, null, 'testEvent');\nconsole.log(\"Appending...\");\nesConnection.appendToStream(streamName, esClient.expectedVersion.any, event)\n    .then(function(result) {\n        console.log(\"Stored event:\", eventId);\n        console.log(\"Look for it at: http://localhost:2113/web/index.html#/streams/testStream\");\n        esConnection.close();\n    })\n    .catch(function(err) {\n        console.log(err);\n    });\n```\n\nRun:\n\n```json\nnpm install uuid\nnpm install node-eventstore-client\nnode app.js\n```\n\n### Example: Subscribing to events\n\n```cd samples```\n\nTo subscribe to all events from now on (includes example of a filter which ignores events which we aren't interested in):\n\n```node subscribe-all-events.js```\n\nTo catch up on all events ever and subscribe to all new ones from now on:\n\n```node subscribe-catchup-all-events.js```\n\nTo generate a test event, open a separate console and run:\n\n```node store-event.js```\n\n## Running the tests\n\n### Local testing\n\nTo run the tests it is recommended that you use an in-memory instance of the eventstore so you don't pollute your dev instance.\n\n    EventStore.ClusterNode.exe --run-projections=all --memdb –certificate-file=yourcert.pfx\n    or\n    ./run-node.sh --run-projections=all --memdb –certificate-file=yourcert.p12\n\nYou can also use docker-compose :\n\n```bash\n# start the single node cluster\nnpm run compose:single:start\n# if you want to wait for the cluster to be available\nnpm run compose:wait\n# run the tests\nnpm run test\n# to cleanup (stop containres, delete volumes)\nnpm run compose:single:stop\n```\n\nFor SSL setup see:\n\nhttps://eventstore.org/docs/server/setting_up_ssl/  \nor  \nhttps://eventstore.org/docs/server/setting_up_ssl_linux/\n\nTo execute the tests suites simply run\n\n    npm test\n\n### Isolated environment\n\nTo be able to run the tests for different connection types (tcp, gossip, cluster) docker-compose files are available to setup the environment and run the tests.\n\n#### Prerequisites\n\n* docker\n* docker-compose\n\n#### Run\n\nTo execute the tests suites for single node cluster (tcp connection) simply run\n\n    npm run test:single\n\nTo execute the tests suites for multiple nodes cluster (gossip connection) simply run\n\n    npm run test:gossip\n\nTo execute the tests suites for multiple nodes cluster (dns discovery connection) simply run\n\n    npm run test:cluster\n\n## Porting .Net Task to Node.js\n\nAny async commands returns a [Promise](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Promise) object in replacement of .Net Task.  \n\n\n## License\n\nPorted code is released under the MIT license, see [LICENSE](https://github.com/nicdex/node-eventstore-client/blob/master/LICENSE). \n \nOriginal code is released under the EventStore license and can be found at https://github.com/eventstore/eventstore.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicdex%2Fnode-eventstore-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicdex%2Fnode-eventstore-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicdex%2Fnode-eventstore-client/lists"}