{"id":13406288,"url":"https://github.com/jaredwray/keyv","last_synced_at":"2026-01-21T02:05:20.095Z","repository":{"id":36973120,"uuid":"96540810","full_name":"jaredwray/keyv","owner":"jaredwray","description":"Simple key-value storage with support for multiple backends","archived":false,"fork":false,"pushed_at":"2026-01-04T22:05:19.000Z","size":4875,"stargazers_count":3068,"open_issues_count":0,"forks_count":192,"subscribers_count":19,"default_branch":"main","last_synced_at":"2026-01-05T06:00:00.003Z","etag":null,"topics":["cache","etcd","key-value","keyv","memcache","mongo","mysql","postgres","redis","sqlite","storage"],"latest_commit_sha":null,"homepage":"https://keyv.org","language":"TypeScript","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/jaredwray.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"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":null,"dco":null,"cla":null}},"created_at":"2017-07-07T13:24:15.000Z","updated_at":"2026-01-04T22:05:14.000Z","dependencies_parsed_at":"2023-07-17T20:41:37.207Z","dependency_job_id":"79b1da5e-e47f-4c65-aa3f-ddf6d9c9414e","html_url":"https://github.com/jaredwray/keyv","commit_stats":{"total_commits":1368,"total_committers":60,"mean_commits":22.8,"dds":0.3223684210526315,"last_synced_commit":"0a18d37d5ce48dd732ed0b3cb1b265a6a2a0489e"},"previous_names":["lukechilds/keyv","keyvjs/keyv"],"tags_count":131,"template":false,"template_full_name":null,"purl":"pkg:github/jaredwray/keyv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaredwray%2Fkeyv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaredwray%2Fkeyv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaredwray%2Fkeyv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaredwray%2Fkeyv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jaredwray","download_url":"https://codeload.github.com/jaredwray/keyv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaredwray%2Fkeyv/sbom","scorecard":{"id":506488,"data":{"date":"2025-08-11","repo":{"name":"github.com/jaredwray/keyv","commit":"06a151ed780826c80e98764a57a5a8ba6854078b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.7,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","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":"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":"Code-Review","score":1,"reason":"Found 4/30 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":"Maintained","score":10,"reason":"30 commit(s) and 20 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":"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":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:28","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:29","Warn: topLevel 'contents' permission set to 'write': .github/workflows/codecov.yaml:10","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/deploy-website.yml:8","Info: topLevel 'contents' permission set to 'read': .github/workflows/tests.yaml:10","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":"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":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"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":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"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":"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":"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/codecov.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codecov.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/codecov.yaml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/tests.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/tests.yaml/main?enable=pin","Warn: containerImage not pinned by hash: packages/postgres/Dockerfile.ssl:1: pin your Docker image by updating postgres:latest to postgres:latest@sha256:19ad070ea172efd48d7cae52297caaf845a3625728674bbc1a6efb679ab7befe","Warn: npmCommand not pinned by hash: .github/workflows/codecov.yaml:25","Warn: npmCommand not pinned by hash: .github/workflows/deploy-website.yml:27","Warn: npmCommand not pinned by hash: .github/workflows/tests.yaml:28","Info:   0 out of  10 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   3 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":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: all commits (17) 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"}}]},"last_synced_at":"2025-08-19T23:20:46.249Z","repository_id":36973120,"created_at":"2025-08-19T23:20:46.249Z","updated_at":"2025-08-19T23:20:46.249Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28241077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-08T02:00:06.591Z","response_time":241,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cache","etcd","key-value","keyv","memcache","mongo","mysql","postgres","redis","sqlite","storage"],"created_at":"2024-07-30T19:02:26.316Z","updated_at":"2026-01-21T02:05:20.085Z","avatar_url":"https://github.com/jaredwray.png","language":"TypeScript","readme":"\u003ch1 align=\"center\"\u003e\u003cimg width=\"250\" src=\"https://jaredwray.com/images/keyv.svg\" alt=\"keyv\"\u003e\u003c/h1\u003e\n\n\u003e Simple key-value storage with support for multiple backends\n\n[![build](https://github.com/jaredwray/keyv/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/keyv/actions/workflows/tests.yaml)\n[![bun](https://github.com/jaredwray/keyv/actions/workflows/bun-test.yaml/badge.svg)](https://github.com/jaredwray/keyv/actions/workflows/bun-test.yaml)\n[![codecov](https://codecov.io/gh/jaredwray/keyv/graph/badge.svg?token=bRzR3RyOXZ)](https://codecov.io/gh/jaredwray/keyv)\n[![npm](https://img.shields.io/npm/dm/keyv.svg)](https://www.npmjs.com/package/keyv)\n[![npm](https://img.shields.io/npm/v/keyv.svg)](https://www.npmjs.com/package/keyv)\n\n# How to Use the Keyv Mono Repo\n\nKeyv and its storage adapters are in this mono repo and there are details below on how to use this repository. In addtion we have a couple of other documents for review:\n\n* [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) - Our code of conduct\n* [CONTRIBUTING](CONTRIBUTING.md) - How to contribute to this project\n* [SECURITY](SECURITY.md) - Security guidelines and supported versions\n\n## Getting Started\n\nKeyv is a simple key-value storage system that supports multiple backends. It's designed to be a simple and consistent way to work with key-value stores.\n\nTo learn how to use Keyv, check out the [keyv](https://github.com/jaredwray/keyv/blob/main/packages/keyv/README.md) README. To learn how to use a specific storage adapter, check out the README for that adapter under [Storage Adapters](#storage-adapters).\n\n## Open a Pull Request\n\nYou can contribute changes to this repo by opening a pull request:\n\n1) After forking this repository to your Git account, make the proposed changes on your forked branch.\n2) Run tests and linting locally.\n\t- [Install and run Docker](https://docs.docker.com/get-docker/) if you aren't already. NOTE: on docker set `enable host networking` to true as it is required for the tests in redis clustering.\n\t- Run `pnpm test:services:start`, allow for the services to come up.\n\t- Run `pnpm test`.\n3) Commit your changes and push them to your forked repository.\n4) Navigate to the main `keyv` repository and select the *Pull Requests* tab.\n5) Click the *New pull request* button, then select the option \"Compare across forks\"\n6) Leave the base branch set to main. Set the compare branch to your forked branch, and open the pull request.\n7) Once your pull request is created, ensure that all checks have passed and that your branch has no conflicts with the base branch. If there are any issues, resolve these changes in your local repository, and then commit and push them to git.\n8) Similarly, respond to any reviewer comments or requests for changes by making edits to your local repository and pushing them to Git.\n9) Once the pull request has been reviewed, those with write access to the branch will be able to merge your changes into the `keyv` repository.\n\nIf you need more information on the steps to create a pull request, you can find a detailed walkthrough in the [Github documentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)\n\n## Post an Issue\n\nTo post an issue, navigate to the \"Issues\" tab in the main repository, and then select \"New Issue.\" Enter a clear title describing the issue, as well as a description containing additional relevant information. Also select the label that best describes your issue type. For a bug report, for example, create an issue with the label \"bug.\" In the description field, Be sure to include replication steps, as well as any relevant error messages.\n\nIf you're reporting a security violation, be sure to check out the project's [security policy](https://github.com/jaredwray/keyv/blob/main/SECURITY.md).\n\nPlease also refer to our [Code of Conduct](https://github.com/jaredwray/keyv/blob/main/CODE_OF_CONDUCT.md) for more information on how to report issues.\n\n## Ask a Question\n\nTo ask a question, create an issue with the label \"question.\" In the issue description, include the related code and any context that can help us answer your question.\n\n## Request the Addition of a Storage Adapter\n\nTo request a new storage adapter, create an issue with the label \"storage adapter.\" In the issue description, include any relevant information about the storage adapter that you would like to be added. \n\nOnce this request has been submitted in \"issues\" we will give it 30-60 days for any upvotes to take place. If there is little interest in the request, it will be closed.\n\nIf there is already an adapter that you would like to add, please post an issue with the label \"storage adapter\" and include the name of the adapter you would like to add with the description and any relevant information. \n\n## Packages in this Repository\n\n* [keyv](https://github.com/jaredwray/keyv/tree/main/packages/keyv): Simple key-value storage with support for multiple backends\n* [test-suite](https://github.com/jaredwray/keyv/tree/main/packages/test-suite): Test suite for Keyv API compliance\n\n### Storage Adapters in this Repository\n\n* [etcd](https://github.com/jaredwray/keyv/tree/main/packages/etcd): Etcd storage adapter\n* [memcache](https://github.com/jaredwray/keyv/tree/main/packages/memcache): Memcache storage adapter\n* [mongo](https://github.com/jaredwray/keyv/tree/main/packages/mongo): MongoDB storage adapter\n* [mysql](https://github.com/jaredwray/keyv/tree/main/packages/mysql): MySQL/MariaDB storage adapter\n* [postgres](https://github.com/jaredwray/keyv/tree/main/packages/postgres): PostgreSQL storage adapter\n* [redis](https://github.com/jaredwray/keyv/tree/main/packages/redis): Redis storage adapter\n* [valkey](https://github.com/jaredwray/keyv/tree/main/packages/valkey): Valkey (Open Source Redis) storage adapter\n* [sqlite](https://github.com/jaredwray/keyv/tree/main/packages/sqlite): SQLite storage adapter\n\n### Compression Adapters in this Repository\n\n* [brotli](https://github.com/jaredwray/keyv/tree/main/packages/compress-brotli): brotli compression adapter\n* [gzip](https://github.com/jaredwray/keyv/tree/main/packages/compress-gzip): gzip compression adapter\n* [lz4](https://github.com/jaredwray/keyv/tree/main/packages/compress-lz4): lz4 compression adapter\n\n### Third-party Storage Adapters\n\nWe love the community and the third-party storage adapters they have built. They enable Keyv to be used with even more backends and use cases.\n\nView the complete list of third-party storage adapters and learn how to build your own at https://keyv.org/docs/third-party-storage-adapters/\n\n## License\n\n[MIT © Jared Wray](./LICENSE)\n","funding_links":[],"categories":["TypeScript","Packages","包","JavaScript","sqlite"],"sub_categories":["Database","数据库"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaredwray%2Fkeyv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaredwray%2Fkeyv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaredwray%2Fkeyv/lists"}