keyv 4.0.5 → 4.1.0

package/.nyc_output/67b1f344-0eec-41a3-a665-c824c346e898.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/adb04494-7d0a-443f-9130-94b19c3fa19c.json

@@ -0,0 +1 @@
+{"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js":{"path":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js","statementMap":{"0":{"start":{"line":3,"column":21},"end":{"line":3,"column":38}},"1":{"start":{"line":4,"column":14},"end":{"line":4,"column":36}},"2":{"start":{"line":7,"column":0},"end":{"line":9,"column":2}},"3":{"start":{"line":8,"column":1},"end":{"line":8,"column":24}},"4":{"start":{"line":11,"column":18},"end":{"line":28,"column":1}},"5":{"start":{"line":12,"column":18},"end":{"line":21,"column":2}},"6":{"start":{"line":22,"column":1},"end":{"line":25,"column":2}},"7":{"start":{"line":23,"column":18},"end":{"line":23,"column":66}},"8":{"start":{"line":24,"column":2},"end":{"line":24,"column":51}},"9":{"start":{"line":27,"column":1},"end":{"line":27,"column":18}},"10":{"start":{"line":32,"column":2},"end":{"line":32,"column":10}},"11":{"start":{"line":33,"column":2},"end":{"line":41,"column":4}},"12":{"start":{"line":43,"column":2},"end":{"line":46,"column":3}},"13":{"start":{"line":44,"column":26},"end":{"line":44,"column":54}},"14":{"start":{"line":45,"column":3},"end":{"line":45,"column":47}},"15":{"start":{"line":48,"column":2},"end":{"line":50,"column":3}},"16":{"start":{"line":49,"column":3},"end":{"line":49,"column":67}},"17":{"start":{"line":49,"column":40},"end":{"line":49,"column":65}},"18":{"start":{"line":52,"column":2},"end":{"line":52,"column":50}},"19":{"start":{"line":56,"column":2},"end":{"line":56,"column":41}},"20":{"start":{"line":60,"column":22},"end":{"line":60,"column":45}},"21":{"start":{"line":61,"column":20},"end":{"line":61,"column":29}},"22":{"start":{"line":62,"column":2},"end":{"line":76,"column":6}},"23":{"start":{"line":63,"column":15},"end":{"line":63,"column":37}},"24":{"start":{"line":64,"column":17},"end":{"line":64,"column":80}},"25":{"start":{"line":66,"column":4},"end":{"line":68,"column":5}},"26":{"start":{"line":67,"column":5},"end":{"line":67,"column":22}},"27":{"start":{"line":70,"column":4},"end":{"line":73,"column":5}},"28":{"start":{"line":71,"column":5},"end":{"line":71,"column":22}},"29":{"start":{"line":72,"column":5},"end":{"line":72,"column":22}},"30":{"start":{"line":75,"column":4},"end":{"line":75,"column":56}},"31":{"start":{"line":80,"column":22},"end":{"line":80,"column":45}},"32":{"start":{"line":81,"column":2},"end":{"line":83,"column":3}},"33":{"start":{"line":82,"column":3},"end":{"line":82,"column":23}},"34":{"start":{"line":85,"column":2},"end":{"line":87,"column":3}},"35":{"start":{"line":86,"column":3},"end":{"line":86,"column":19}},"36":{"start":{"line":89,"column":20},"end":{"line":89,"column":29}},"37":{"start":{"line":91,"column":2},"end":{"line":102,"column":21}},"38":{"start":{"line":93,"column":20},"end":{"line":93,"column":73}},"39":{"start":{"line":94,"column":4},"end":{"line":96,"column":5}},"40":{"start":{"line":95,"column":5},"end":{"line":95,"column":55}},"41":{"start":{"line":98,"column":4},"end":{"line":98,"column":31}},"42":{"start":{"line":99,"column":4},"end":{"line":99,"column":38}},"43":{"start":{"line":101,"column":18},"end":{"line":101,"column":52}},"44":{"start":{"line":102,"column":15},"end":{"line":102,"column":19}},"45":{"start":{"line":106,"column":22},"end":{"line":106,"column":45}},"46":{"start":{"line":107,"column":20},"end":{"line":107,"column":29}},"47":{"start":{"line":108,"column":2},"end":{"line":109,"column":42}},"48":{"start":{"line":109,"column":15},"end":{"line":109,"column":40}},"49":{"start":{"line":113,"column":20},"end":{"line":113,"column":29}},"50":{"start":{"line":114,"column":2},"end":{"line":115,"column":30}},"51":{"start":{"line":115,"column":15},"end":{"line":115,"column":28}},"52":{"start":{"line":119,"column":0},"end":{"line":119,"column":22}}},"fnMap":{"0":{"name":"(anonymous_0)","decl":{"start":{"line":7,"column":26},"end":{"line":7,"column":27}},"loc":{"start":{"line":7,"column":38},"end":{"line":9,"column":1}},"line":7},"1":{"name":"(anonymous_1)","decl":{"start":{"line":11,"column":18},"end":{"line":11,"column":19}},"loc":{"start":{"line":11,"column":29},"end":{"line":28,"column":1}},"line":11},"2":{"name":"(anonymous_2)","decl":{"start":{"line":31,"column":1},"end":{"line":31,"column":2}},"loc":{"start":{"line":31,"column":27},"end":{"line":53,"column":2}},"line":31},"3":{"name":"(anonymous_3)","decl":{"start":{"line":49,"column":31},"end":{"line":49,"column":32}},"loc":{"start":{"line":49,"column":40},"end":{"line":49,"column":65}},"line":49},"4":{"name":"(anonymous_4)","decl":{"start":{"line":55,"column":1},"end":{"line":55,"column":2}},"loc":{"start":{"line":55,"column":20},"end":{"line":57,"column":2}},"line":55},"5":{"name":"(anonymous_5)","decl":{"start":{"line":59,"column":1},"end":{"line":59,"column":2}},"loc":{"start":{"line":59,"column":19},"end":{"line":77,"column":2}},"line":59},"6":{"name":"(anonymous_6)","decl":{"start":{"line":63,"column":9},"end":{"line":63,"column":10}},"loc":{"start":{"line":63,"column":15},"end":{"line":63,"column":37}},"line":63},"7":{"name":"(anonymous_7)","decl":{"start":{"line":64,"column":9},"end":{"line":64,"column":10}},"loc":{"start":{"line":64,"column":17},"end":{"line":64,"column":80}},"line":64},"8":{"name":"(anonymous_8)","decl":{"start":{"line":65,"column":9},"end":{"line":65,"column":10}},"loc":{"start":{"line":65,"column":17},"end":{"line":76,"column":4}},"line":65},"9":{"name":"(anonymous_9)","decl":{"start":{"line":79,"column":1},"end":{"line":79,"column":2}},"loc":{"start":{"line":79,"column":22},"end":{"line":103,"column":2}},"line":79},"10":{"name":"(anonymous_10)","decl":{"start":{"line":92,"column":9},"end":{"line":92,"column":10}},"loc":{"start":{"line":92,"column":15},"end":{"line":100,"column":4}},"line":92},"11":{"name":"(anonymous_11)","decl":{"start":{"line":101,"column":9},"end":{"line":101,"column":10}},"loc":{"start":{"line":101,"column":18},"end":{"line":101,"column":52}},"line":101},"12":{"name":"(anonymous_12)","decl":{"start":{"line":102,"column":9},"end":{"line":102,"column":10}},"loc":{"start":{"line":102,"column":15},"end":{"line":102,"column":19}},"line":102},"13":{"name":"(anonymous_13)","decl":{"start":{"line":105,"column":1},"end":{"line":105,"column":2}},"loc":{"start":{"line":105,"column":13},"end":{"line":110,"column":2}},"line":105},"14":{"name":"(anonymous_14)","decl":{"start":{"line":109,"column":9},"end":{"line":109,"column":10}},"loc":{"start":{"line":109,"column":15},"end":{"line":109,"column":40}},"line":109},"15":{"name":"(anonymous_15)","decl":{"start":{"line":112,"column":1},"end":{"line":112,"column":2}},"loc":{"start":{"line":112,"column":9},"end":{"line":116,"column":2}},"line":112},"16":{"name":"(anonymous_16)","decl":{"start":{"line":115,"column":9},"end":{"line":115,"column":10}},"loc":{"start":{"line":115,"column":15},"end":{"line":115,"column":28}},"line":115}},"branchMap":{"0":{"loc":{"start":{"line":22,"column":1},"end":{"line":25,"column":2}},"type":"if","locations":[{"start":{"line":22,"column":1},"end":{"line":25,"column":2}},{"start":{"line":22,"column":1},"end":{"line":25,"column":2}}],"line":22},"1":{"loc":{"start":{"line":22,"column":5},"end":{"line":22,"column":35}},"type":"binary-expr","locations":[{"start":{"line":22,"column":5},"end":{"line":22,"column":20}},{"start":{"line":22,"column":24},"end":{"line":22,"column":35}}],"line":22},"2":{"loc":{"start":{"line":23,"column":18},"end":{"line":23,"column":66}},"type":"binary-expr","locations":[{"start":{"line":23,"column":18},"end":{"line":23,"column":33}},{"start":{"line":23,"column":37},"end":{"line":23,"column":66}}],"line":23},"3":{"loc":{"start":{"line":39,"column":3},"end":{"line":39,"column":44}},"type":"cond-expr","locations":[{"start":{"line":39,"column":31},"end":{"line":39,"column":38}},{"start":{"line":39,"column":41},"end":{"line":39,"column":44}}],"line":39},"4":{"loc":{"start":{"line":43,"column":2},"end":{"line":46,"column":3}},"type":"if","locations":[{"start":{"line":43,"column":2},"end":{"line":46,"column":3}},{"start":{"line":43,"column":2},"end":{"line":46,"column":3}}],"line":43},"5":{"loc":{"start":{"line":48,"column":2},"end":{"line":50,"column":3}},"type":"if","locations":[{"start":{"line":48,"column":2},"end":{"line":50,"column":3}},{"start":{"line":48,"column":2},"end":{"line":50,"column":3}}],"line":48},"6":{"loc":{"start":{"line":64,"column":17},"end":{"line":64,"column":80}},"type":"cond-expr","locations":[{"start":{"line":64,"column":46},"end":{"line":64,"column":73}},{"start":{"line":64,"column":76},"end":{"line":64,"column":80}}],"line":64},"7":{"loc":{"start":{"line":66,"column":4},"end":{"line":68,"column":5}},"type":"if","locations":[{"start":{"line":66,"column":4},"end":{"line":68,"column":5}},{"start":{"line":66,"column":4},"end":{"line":68,"column":5}}],"line":66},"8":{"loc":{"start":{"line":66,"column":8},"end":{"line":66,"column":43}},"type":"binary-expr","locations":[{"start":{"line":66,"column":8},"end":{"line":66,"column":26}},{"start":{"line":66,"column":30},"end":{"line":66,"column":43}}],"line":66},"9":{"loc":{"start":{"line":70,"column":4},"end":{"line":73,"column":5}},"type":"if","locations":[{"start":{"line":70,"column":4},"end":{"line":73,"column":5}},{"start":{"line":70,"column":4},"end":{"line":73,"column":5}}],"line":70},"10":{"loc":{"start":{"line":70,"column":8},"end":{"line":70,"column":69}},"type":"binary-expr","locations":[{"start":{"line":70,"column":8},"end":{"line":70,"column":40}},{"start":{"line":70,"column":44},"end":{"line":70,"column":69}}],"line":70},"11":{"loc":{"start":{"line":75,"column":11},"end":{"line":75,"column":55}},"type":"cond-expr","locations":[{"start":{"line":75,"column":38},"end":{"line":75,"column":42}},{"start":{"line":75,"column":45},"end":{"line":75,"column":55}}],"line":75},"12":{"loc":{"start":{"line":75,"column":12},"end":{"line":75,"column":34}},"type":"binary-expr","locations":[{"start":{"line":75,"column":12},"end":{"line":75,"column":19}},{"start":{"line":75,"column":23},"end":{"line":75,"column":34}}],"line":75},"13":{"loc":{"start":{"line":81,"column":2},"end":{"line":83,"column":3}},"type":"if","locations":[{"start":{"line":81,"column":2},"end":{"line":83,"column":3}},{"start":{"line":81,"column":2},"end":{"line":83,"column":3}}],"line":81},"14":{"loc":{"start":{"line":85,"column":2},"end":{"line":87,"column":3}},"type":"if","locations":[{"start":{"line":85,"column":2},"end":{"line":87,"column":3}},{"start":{"line":85,"column":2},"end":{"line":87,"column":3}}],"line":85},"15":{"loc":{"start":{"line":93,"column":20},"end":{"line":93,"column":73}},"type":"cond-expr","locations":[{"start":{"line":93,"column":49},"end":{"line":93,"column":65}},{"start":{"line":93,"column":69},"end":{"line":93,"column":73}}],"line":93},"16":{"loc":{"start":{"line":94,"column":4},"end":{"line":96,"column":5}},"type":"if","locations":[{"start":{"line":94,"column":4},"end":{"line":96,"column":5}},{"start":{"line":94,"column":4},"end":{"line":96,"column":5}}],"line":94}},"s":{"0":1,"1":1,"2":1,"3":0,"4":1,"5":3,"6":3,"7":2,"8":2,"9":1,"10":197,"11":197,"12":197,"13":3,"14":3,"15":197,"16":188,"17":1,"18":197,"19":95,"20":46,"21":46,"22":46,"23":46,"24":46,"25":46,"26":9,"27":37,"28":5,"29":5,"30":32,"31":39,"32":39,"33":34,"34":39,"35":1,"36":39,"37":39,"38":39,"39":39,"40":1,"41":38,"42":38,"43":38,"44":38,"45":10,"46":10,"47":10,"48":10,"49":163,"50":163,"51":163,"52":1},"f":{"0":0,"1":3,"2":197,"3":1,"4":95,"5":46,"6":46,"7":46,"8":46,"9":39,"10":39,"11":38,"12":38,"13":10,"14":10,"15":163,"16":163},"b":{"0":[2,1],"1":[3,3],"2":[2,2],"3":[2,195],"4":[3,194],"5":[188,9],"6":[37,9],"7":[9,37],"8":[46,37],"9":[5,32],"10":[37,13],"11":[1,31],"12":[32,1],"13":[34,5],"14":[1,38],"15":[6,33],"16":[1,38]},"_coverageSchema":"1a1c01bbd47fc00a2c39e90264f33305004495a9","hash":"a1f9f50840413fbf8dec11cc75e741387da8a6d0","contentHash":"0ecb4ae8fe157ca1a77008538c0b536709aa7c13d364d4266adea5319bee04f1"}}

package/.nyc_output/processinfo/17c338d1-cd21-4d2f-9d97-398f18a945cf.json

@@ -0,0 +1 @@
+{"parent":"67b1f344-0eec-41a3-a665-c824c346e898","pid":4476,"argv":["/Users/jaredwray/.nvm/versions/node/v16.13.1/bin/node","/Users/jaredwray/src/github.com/jaredwray/keyv/node_modules/update-notifier/check.js","{\"pkg\":{\"name\":\"ava\",\"version\":\"3.15.0\"},\"distTag\":\"latest\"}"],"execArgv":[],"cwd":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv","time":1643754172416,"ppid":4475,"coverageFilename":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/.nyc_output/17c338d1-cd21-4d2f-9d97-398f18a945cf.json","externalId":"","uuid":"17c338d1-cd21-4d2f-9d97-398f18a945cf","files":[]}

package/.nyc_output/processinfo/67b1f344-0eec-41a3-a665-c824c346e898.json

@@ -0,0 +1 @@
+{"parent":null,"pid":4475,"argv":["/Users/jaredwray/.nvm/versions/node/v16.13.1/bin/node","/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/node_modules/.bin/ava","--serial"],"execArgv":[],"cwd":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv","time":1643754172273,"ppid":4474,"coverageFilename":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/.nyc_output/67b1f344-0eec-41a3-a665-c824c346e898.json","externalId":"","uuid":"67b1f344-0eec-41a3-a665-c824c346e898","files":[]}

package/.nyc_output/processinfo/adb04494-7d0a-443f-9130-94b19c3fa19c.json

@@ -0,0 +1 @@
+{"parent":"67b1f344-0eec-41a3-a665-c824c346e898","pid":4477,"argv":["/Users/jaredwray/.nvm/versions/node/v16.13.1/bin/node","/Users/jaredwray/src/github.com/jaredwray/keyv/node_modules/ava/lib/worker/subprocess.js"],"execArgv":[],"cwd":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv","time":1643754172556,"ppid":4475,"coverageFilename":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/.nyc_output/adb04494-7d0a-443f-9130-94b19c3fa19c.json","externalId":"","uuid":"adb04494-7d0a-443f-9130-94b19c3fa19c","files":["/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js"]}

package/.nyc_output/processinfo/index.json

@@ -1 +1 @@
-{"processes":{"37411020-4142-4b08-b825-343ba2427bf7":{"parent":null,"children":["cd79f2de-c8b8-4493-bc15-b2bde28efa4b"]},"cd79f2de-c8b8-4493-bc15-b2bde28efa4b":{"parent":"37411020-4142-4b08-b825-343ba2427bf7","children":[]}},"files":{"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js":["cd79f2de-c8b8-4493-bc15-b2bde28efa4b"]},"externalIds":{}}
+{"processes":{"17c338d1-cd21-4d2f-9d97-398f18a945cf":{"parent":"67b1f344-0eec-41a3-a665-c824c346e898","children":[]},"67b1f344-0eec-41a3-a665-c824c346e898":{"parent":null,"children":["17c338d1-cd21-4d2f-9d97-398f18a945cf","adb04494-7d0a-443f-9130-94b19c3fa19c"]},"adb04494-7d0a-443f-9130-94b19c3fa19c":{"parent":"67b1f344-0eec-41a3-a665-c824c346e898","children":[]}},"files":{"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js":["adb04494-7d0a-443f-9130-94b19c3fa19c"]},"externalIds":{}}

package/README.md

@@ -6,7 +6,7 @@
 
 > Simple key-value storage with support for multiple backends
 
-[![build](https://github.com/jaredwray/keyv/actions/workflows/build.yaml/badge.svg)](https://github.com/jaredwray/keyv/actions/workflows/build.yaml)
+[![build](https://github.com/jaredwray/keyv/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/keyv/actions/workflows/tests.yaml)
 [![codecov](https://codecov.io/gh/jaredwray/keyv/branch/master/graph/badge.svg?token=bRzR3RyOXZ)](https://codecov.io/gh/jaredwray/keyv)
 [![npm](https://img.shields.io/npm/dm/keyv.svg)](https://www.npmjs.com/package/keyv)
 [![npm](https://img.shields.io/npm/v/keyv.svg)](https://www.npmjs.com/package/keyv)
@@ -44,6 +44,7 @@ npm install --save @keyv/mongo
 npm install --save @keyv/sqlite
 npm install --save @keyv/postgres
 npm install --save @keyv/mysql
+npm install --save @keyv/etcd
 ```
 
 Create a new Keyv instance, passing your connection string if applicable. Keyv will automatically load the correct storage adapter.
@@ -58,6 +59,7 @@ const keyv = new Keyv('mongodb://user:pass@localhost:27017/dbname');
 const keyv = new Keyv('sqlite://path/to/database.sqlite');
 const keyv = new Keyv('postgresql://user:pass@localhost:5432/dbname');
 const keyv = new Keyv('mysql://user:pass@localhost:3306/dbname');
+const keyv = new Keyv('etcd://localhost:2379');
 
 // Handle DB connection errors
 keyv.on('error', err => console.log('Connection Error', err));
@@ -100,7 +102,7 @@ const keyv = new Keyv({ serialize: JSON.stringify, deserialize: JSON.parse });
 
 ## Official Storage Adapters
 
-The official storage adapters are covered by [over 150 integration tests](https://github.com/jaredwray/keyv/actions/workflows/build.yaml) to guarantee consistent behaviour. They are lightweight, efficient wrappers over the DB clients making use of indexes and native TTLs where available.
+The official storage adapters are covered by [over 150 integration tests](https://github.com/jaredwray/keyv/actions/workflows/tests.yaml) to guarantee consistent behaviour. They are lightweight, efficient wrappers over the DB clients making use of indexes and native TTLs where available.
 
 Database | Adapter | Native TTL
 ---|---|---
@@ -109,6 +111,7 @@ MongoDB | [@keyv/mongo](https://github.com/jaredwray/keyv/tree/master/packages/m
 SQLite | [@keyv/sqlite](https://github.com/jaredwray/keyv/tree/master/packages/sqlite) | No 
 PostgreSQL | [@keyv/postgres](https://github.com/jaredwray/keyv/tree/master/packages/postgres) | No 
 MySQL | [@keyv/mysql](https://github.com/jaredwray/keyv/tree/master/packages/mysql) | No 
+Etcd | [@keyv/etcd](https://github.com/jaredwray/keyv/tree/master/packages/etcd) | Yes
 
 ## Third-party Storage Adapters
 
@@ -286,6 +289,84 @@ Delete all entries in the current namespace.
 
 Returns a promise which is resolved when the entries have been cleared.
 
+# How to Contribute
+
+In this section of the documentation we will cover:
+
+1) How to set up this repository locally
+2) How to get started with running commands
+3) How to contribute changes using Pull Requests
+
+## Dependencies
+
+This package requires the following dependencies to run:
+
+1) [Yarn V1](https://yarnpkg.com/getting-started/install)
+2) [Lerna](https://lerna.js.org/)
+3) [Docker](https://docs.docker.com/get-docker/)
+
+## Setting up your workspace
+
+To contribute to this repository, start by setting up this project locally:
+
+1) Fork this repository into your Git account
+2) Clone the forked repository to your local directory using `git clone`
+3) Install any of the above missing dependencies
+
+## Launching the project
+
+Once the project is installed locally, you are ready to start up its services:
+
+1) Ensure that your Docker service is running.
+2) From the root directory of your project, run the `yarn` command in the command prompt to install yarn.
+3) Run the `yarn bootstrap` command to  install any necessary dependencies.
+4) Run `yarn test:services:start` to start up this project's Docker container. The container will launch all services within your workspace.
+
+## Available Commands
+
+Once the project is running, you can execute a variety of commands. The root workspace and each subpackage contain a `package.json` file with a  `scripts` field listing all the commands that can be executed from that directory. This project also supports native `yarn`, `lerna`, and `docker` commands.
+
+Here, we'll cover the primary commands that can be executed from the root directory. Unless otherwise noted, these commands can also be executed from a subpackage. If executed from a subpackage, they will only affect that subpackage, rather than the entire workspace.
+
+### `yarn`
+
+The `yarn` command installs yarn in the workspace.
+
+### `yarn bootstrap`
+
+The `yarn bootstrap` command installs all dependencies in the workspace.
+
+### `yarn test:services:start`
+
+The `yarn test:services:start` command starts up the project's Docker container, launching all services in the workspace. This command must be executed from the root directory.
+
+### `yarn test:services:stop`
+
+The `yarn test:services:stop` command brings down the project's Docker container, halting all services. This command must be executed from the root directory.
+
+### `yarn test`
+
+The `yarn test` command runs all tests in the workspace.
+
+### `yarn clean`
+
+The `yarn clean` command removes yarn and all dependencies installed by yarn. After executing this command, you must repeat the steps in *Setting up your workspace* to rebuild your workspace.
+
+## Contributing Changes
+
+Now that you've set up your workspace, you're ready to contribute changes to the `keyv` repository.
+
+1) Make any changes that you would like to contribute in your local workspace.
+2) After making these changes, ensure that the project's tests still pass by executing the `yarn test` command in the root directory.
+3) Commit your changes and push them to your forked repository.
+4) Navigate to the original `keyv` repository and go the *Pull Requests* tab.
+5) Click the *New pull request* button, and open a pull request for the branch in your repository that contains your changes.
+6) 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.
+7) Similarly, respond to any reviewer comments or requests for changes by making edits to your local repository and pushing them to Git.
+8) 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.
+
+If 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)
+
 ## License
 
 MIT © Jared Wray & Luke Childs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyv",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "description": "Simple key-value storage with support for multiple backends",
   "main": "src/index.js",
   "scripts": {
@@ -35,16 +35,12 @@
     "json-buffer": "3.0.1"
   },
   "devDependencies": {
-    "@keyv/mongo": "*",
-    "@keyv/mysql": "*",
-    "@keyv/postgres": "*",
-    "@keyv/redis": "*",
-    "@keyv/sqlite": "*",
     "@keyv/test-suite": "*",
     "ava": "^3.15.0",
     "eslint-config-xo-lukechilds": "^1.0.0",
     "eslint-plugin-promise": "^5.1.1",
     "nyc": "^15.1.0",
+    "pify": "5.0.0",
     "this": "^1.0.2",
     "timekeeper": "^2.0.0",
     "xo": "^0.46.3"

package/src/index.js

@@ -3,6 +3,11 @@
 const EventEmitter = require('events');
 const JSONB = require('json-buffer');
 
+// eslint-disable-next-line no-extend-native
+BigInt.prototype.toJSON = function () {
+	return this.toString();
+};
+
 const loadStore = options => {
 	const adapters = {
 		redis: '@keyv/redis',
@@ -12,6 +17,7 @@ const loadStore = options => {
 		postgresql: '@keyv/postgres',
 		postgres: '@keyv/postgres',
 		mysql: '@keyv/mysql',
+		etcd: '@keyv/etcd',
 	};
 	if (options.adapter || options.uri) {
 		const adapter = options.adapter || /^[^:]*/.exec(options.uri)[0];
@@ -57,7 +63,7 @@ class Keyv extends EventEmitter {
 			.then(() => store.get(keyPrefixed))
 			.then(data => (typeof data === 'string') ? this.opts.deserialize(data) : data)
 			.then(data => {
-				if (data === undefined) {
+				if (data === undefined || data === null) {
 					return undefined;
 				}
 
@@ -85,6 +91,10 @@ class Keyv extends EventEmitter {
 		return Promise.resolve()
 			.then(() => {
 				const expires = (typeof ttl === 'number') ? (Date.now() + ttl) : null;
+				if (typeof value === 'symbol') {
+					this.emit('error', 'symbol cannot be serialized');
+				}
+
 				value = { value, expires };
 				return this.opts.serialize(value);
 			})

package/test/test.js

@@ -1,12 +1,10 @@
 const test = require('ava');
-const keyvTestSuite = require('@keyv/test-suite').default;
-const { keyvOfficialTests } = require('@keyv/test-suite');
+const { default: keyvTestSuite, keyvOfficialTests } = require('@keyv/test-suite');
 const Keyv = require('this');
 const tk = require('timekeeper');
 const KeyvSqlite = require('@keyv/sqlite');
 
 keyvOfficialTests(test, Keyv, 'sqlite://test/testdb.sqlite', 'sqlite://non/existent/database.sqlite');
-
 const store = () => new KeyvSqlite({ uri: 'sqlite://test/testdb.sqlite', busyTimeout: 3000 });
 keyvTestSuite(test, Keyv, store);
 

package/.nyc_output/cd79f2de-c8b8-4493-bc15-b2bde28efa4b.json

@@ -1 +0,0 @@
-{"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js":{"path":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js","statementMap":{"0":{"start":{"line":3,"column":21},"end":{"line":3,"column":38}},"1":{"start":{"line":4,"column":14},"end":{"line":4,"column":36}},"2":{"start":{"line":6,"column":18},"end":{"line":22,"column":1}},"3":{"start":{"line":7,"column":18},"end":{"line":15,"column":2}},"4":{"start":{"line":16,"column":1},"end":{"line":19,"column":2}},"5":{"start":{"line":17,"column":18},"end":{"line":17,"column":66}},"6":{"start":{"line":18,"column":2},"end":{"line":18,"column":51}},"7":{"start":{"line":21,"column":1},"end":{"line":21,"column":18}},"8":{"start":{"line":26,"column":2},"end":{"line":26,"column":10}},"9":{"start":{"line":27,"column":2},"end":{"line":35,"column":4}},"10":{"start":{"line":37,"column":2},"end":{"line":40,"column":3}},"11":{"start":{"line":38,"column":26},"end":{"line":38,"column":54}},"12":{"start":{"line":39,"column":3},"end":{"line":39,"column":47}},"13":{"start":{"line":42,"column":2},"end":{"line":44,"column":3}},"14":{"start":{"line":43,"column":3},"end":{"line":43,"column":67}},"15":{"start":{"line":43,"column":40},"end":{"line":43,"column":65}},"16":{"start":{"line":46,"column":2},"end":{"line":46,"column":50}},"17":{"start":{"line":50,"column":2},"end":{"line":50,"column":41}},"18":{"start":{"line":54,"column":22},"end":{"line":54,"column":45}},"19":{"start":{"line":55,"column":20},"end":{"line":55,"column":29}},"20":{"start":{"line":56,"column":2},"end":{"line":70,"column":6}},"21":{"start":{"line":57,"column":15},"end":{"line":57,"column":37}},"22":{"start":{"line":58,"column":17},"end":{"line":58,"column":80}},"23":{"start":{"line":60,"column":4},"end":{"line":62,"column":5}},"24":{"start":{"line":61,"column":5},"end":{"line":61,"column":22}},"25":{"start":{"line":64,"column":4},"end":{"line":67,"column":5}},"26":{"start":{"line":65,"column":5},"end":{"line":65,"column":22}},"27":{"start":{"line":66,"column":5},"end":{"line":66,"column":22}},"28":{"start":{"line":69,"column":4},"end":{"line":69,"column":56}},"29":{"start":{"line":74,"column":22},"end":{"line":74,"column":45}},"30":{"start":{"line":75,"column":2},"end":{"line":77,"column":3}},"31":{"start":{"line":76,"column":3},"end":{"line":76,"column":23}},"32":{"start":{"line":79,"column":2},"end":{"line":81,"column":3}},"33":{"start":{"line":80,"column":3},"end":{"line":80,"column":19}},"34":{"start":{"line":83,"column":20},"end":{"line":83,"column":29}},"35":{"start":{"line":85,"column":2},"end":{"line":92,"column":21}},"36":{"start":{"line":87,"column":20},"end":{"line":87,"column":73}},"37":{"start":{"line":88,"column":4},"end":{"line":88,"column":31}},"38":{"start":{"line":89,"column":4},"end":{"line":89,"column":38}},"39":{"start":{"line":91,"column":18},"end":{"line":91,"column":52}},"40":{"start":{"line":92,"column":15},"end":{"line":92,"column":19}},"41":{"start":{"line":96,"column":22},"end":{"line":96,"column":45}},"42":{"start":{"line":97,"column":20},"end":{"line":97,"column":29}},"43":{"start":{"line":98,"column":2},"end":{"line":99,"column":42}},"44":{"start":{"line":99,"column":15},"end":{"line":99,"column":40}},"45":{"start":{"line":103,"column":20},"end":{"line":103,"column":29}},"46":{"start":{"line":104,"column":2},"end":{"line":105,"column":30}},"47":{"start":{"line":105,"column":15},"end":{"line":105,"column":28}},"48":{"start":{"line":109,"column":0},"end":{"line":109,"column":22}}},"fnMap":{"0":{"name":"(anonymous_0)","decl":{"start":{"line":6,"column":18},"end":{"line":6,"column":19}},"loc":{"start":{"line":6,"column":29},"end":{"line":22,"column":1}},"line":6},"1":{"name":"(anonymous_1)","decl":{"start":{"line":25,"column":1},"end":{"line":25,"column":2}},"loc":{"start":{"line":25,"column":27},"end":{"line":47,"column":2}},"line":25},"2":{"name":"(anonymous_2)","decl":{"start":{"line":43,"column":31},"end":{"line":43,"column":32}},"loc":{"start":{"line":43,"column":40},"end":{"line":43,"column":65}},"line":43},"3":{"name":"(anonymous_3)","decl":{"start":{"line":49,"column":1},"end":{"line":49,"column":2}},"loc":{"start":{"line":49,"column":20},"end":{"line":51,"column":2}},"line":49},"4":{"name":"(anonymous_4)","decl":{"start":{"line":53,"column":1},"end":{"line":53,"column":2}},"loc":{"start":{"line":53,"column":19},"end":{"line":71,"column":2}},"line":53},"5":{"name":"(anonymous_5)","decl":{"start":{"line":57,"column":9},"end":{"line":57,"column":10}},"loc":{"start":{"line":57,"column":15},"end":{"line":57,"column":37}},"line":57},"6":{"name":"(anonymous_6)","decl":{"start":{"line":58,"column":9},"end":{"line":58,"column":10}},"loc":{"start":{"line":58,"column":17},"end":{"line":58,"column":80}},"line":58},"7":{"name":"(anonymous_7)","decl":{"start":{"line":59,"column":9},"end":{"line":59,"column":10}},"loc":{"start":{"line":59,"column":17},"end":{"line":70,"column":4}},"line":59},"8":{"name":"(anonymous_8)","decl":{"start":{"line":73,"column":1},"end":{"line":73,"column":2}},"loc":{"start":{"line":73,"column":22},"end":{"line":93,"column":2}},"line":73},"9":{"name":"(anonymous_9)","decl":{"start":{"line":86,"column":9},"end":{"line":86,"column":10}},"loc":{"start":{"line":86,"column":15},"end":{"line":90,"column":4}},"line":86},"10":{"name":"(anonymous_10)","decl":{"start":{"line":91,"column":9},"end":{"line":91,"column":10}},"loc":{"start":{"line":91,"column":18},"end":{"line":91,"column":52}},"line":91},"11":{"name":"(anonymous_11)","decl":{"start":{"line":92,"column":9},"end":{"line":92,"column":10}},"loc":{"start":{"line":92,"column":15},"end":{"line":92,"column":19}},"line":92},"12":{"name":"(anonymous_12)","decl":{"start":{"line":95,"column":1},"end":{"line":95,"column":2}},"loc":{"start":{"line":95,"column":13},"end":{"line":100,"column":2}},"line":95},"13":{"name":"(anonymous_13)","decl":{"start":{"line":99,"column":9},"end":{"line":99,"column":10}},"loc":{"start":{"line":99,"column":15},"end":{"line":99,"column":40}},"line":99},"14":{"name":"(anonymous_14)","decl":{"start":{"line":102,"column":1},"end":{"line":102,"column":2}},"loc":{"start":{"line":102,"column":9},"end":{"line":106,"column":2}},"line":102},"15":{"name":"(anonymous_15)","decl":{"start":{"line":105,"column":9},"end":{"line":105,"column":10}},"loc":{"start":{"line":105,"column":15},"end":{"line":105,"column":28}},"line":105}},"branchMap":{"0":{"loc":{"start":{"line":16,"column":1},"end":{"line":19,"column":2}},"type":"if","locations":[{"start":{"line":16,"column":1},"end":{"line":19,"column":2}},{"start":{"line":16,"column":1},"end":{"line":19,"column":2}}],"line":16},"1":{"loc":{"start":{"line":16,"column":5},"end":{"line":16,"column":35}},"type":"binary-expr","locations":[{"start":{"line":16,"column":5},"end":{"line":16,"column":20}},{"start":{"line":16,"column":24},"end":{"line":16,"column":35}}],"line":16},"2":{"loc":{"start":{"line":17,"column":18},"end":{"line":17,"column":66}},"type":"binary-expr","locations":[{"start":{"line":17,"column":18},"end":{"line":17,"column":33}},{"start":{"line":17,"column":37},"end":{"line":17,"column":66}}],"line":17},"3":{"loc":{"start":{"line":33,"column":3},"end":{"line":33,"column":44}},"type":"cond-expr","locations":[{"start":{"line":33,"column":31},"end":{"line":33,"column":38}},{"start":{"line":33,"column":41},"end":{"line":33,"column":44}}],"line":33},"4":{"loc":{"start":{"line":37,"column":2},"end":{"line":40,"column":3}},"type":"if","locations":[{"start":{"line":37,"column":2},"end":{"line":40,"column":3}},{"start":{"line":37,"column":2},"end":{"line":40,"column":3}}],"line":37},"5":{"loc":{"start":{"line":42,"column":2},"end":{"line":44,"column":3}},"type":"if","locations":[{"start":{"line":42,"column":2},"end":{"line":44,"column":3}},{"start":{"line":42,"column":2},"end":{"line":44,"column":3}}],"line":42},"6":{"loc":{"start":{"line":58,"column":17},"end":{"line":58,"column":80}},"type":"cond-expr","locations":[{"start":{"line":58,"column":46},"end":{"line":58,"column":73}},{"start":{"line":58,"column":76},"end":{"line":58,"column":80}}],"line":58},"7":{"loc":{"start":{"line":60,"column":4},"end":{"line":62,"column":5}},"type":"if","locations":[{"start":{"line":60,"column":4},"end":{"line":62,"column":5}},{"start":{"line":60,"column":4},"end":{"line":62,"column":5}}],"line":60},"8":{"loc":{"start":{"line":64,"column":4},"end":{"line":67,"column":5}},"type":"if","locations":[{"start":{"line":64,"column":4},"end":{"line":67,"column":5}},{"start":{"line":64,"column":4},"end":{"line":67,"column":5}}],"line":64},"9":{"loc":{"start":{"line":64,"column":8},"end":{"line":64,"column":69}},"type":"binary-expr","locations":[{"start":{"line":64,"column":8},"end":{"line":64,"column":40}},{"start":{"line":64,"column":44},"end":{"line":64,"column":69}}],"line":64},"10":{"loc":{"start":{"line":69,"column":11},"end":{"line":69,"column":55}},"type":"cond-expr","locations":[{"start":{"line":69,"column":38},"end":{"line":69,"column":42}},{"start":{"line":69,"column":45},"end":{"line":69,"column":55}}],"line":69},"11":{"loc":{"start":{"line":69,"column":12},"end":{"line":69,"column":34}},"type":"binary-expr","locations":[{"start":{"line":69,"column":12},"end":{"line":69,"column":19}},{"start":{"line":69,"column":23},"end":{"line":69,"column":34}}],"line":69},"12":{"loc":{"start":{"line":75,"column":2},"end":{"line":77,"column":3}},"type":"if","locations":[{"start":{"line":75,"column":2},"end":{"line":77,"column":3}},{"start":{"line":75,"column":2},"end":{"line":77,"column":3}}],"line":75},"13":{"loc":{"start":{"line":79,"column":2},"end":{"line":81,"column":3}},"type":"if","locations":[{"start":{"line":79,"column":2},"end":{"line":81,"column":3}},{"start":{"line":79,"column":2},"end":{"line":81,"column":3}}],"line":79},"14":{"loc":{"start":{"line":87,"column":20},"end":{"line":87,"column":73}},"type":"cond-expr","locations":[{"start":{"line":87,"column":49},"end":{"line":87,"column":65}},{"start":{"line":87,"column":69},"end":{"line":87,"column":73}}],"line":87}},"s":{"0":1,"1":1,"2":1,"3":3,"4":3,"5":2,"6":2,"7":1,"8":187,"9":187,"10":187,"11":3,"12":3,"13":187,"14":178,"15":1,"16":187,"17":92,"18":45,"19":45,"20":45,"21":45,"22":45,"23":45,"24":9,"25":36,"26":5,"27":5,"28":31,"29":37,"30":37,"31":32,"32":37,"33":1,"34":37,"35":37,"36":37,"37":37,"38":37,"39":37,"40":37,"41":10,"42":10,"43":10,"44":10,"45":155,"46":155,"47":155,"48":1},"f":{"0":3,"1":187,"2":1,"3":92,"4":45,"5":45,"6":45,"7":45,"8":37,"9":37,"10":37,"11":37,"12":10,"13":10,"14":155,"15":155},"b":{"0":[2,1],"1":[3,3],"2":[2,2],"3":[2,185],"4":[3,184],"5":[178,9],"6":[36,9],"7":[9,36],"8":[5,31],"9":[36,13],"10":[1,30],"11":[31,1],"12":[32,5],"13":[1,36],"14":[6,31]},"_coverageSchema":"1a1c01bbd47fc00a2c39e90264f33305004495a9","hash":"68d63c1da21bdd17ca5b4661ccb46d430a48aa3d","contentHash":"600469b33bfd3413852cfb4a0f6eb2248472b9c0ecd031c4b7ee54f59a8c8e2c"}}

package/.nyc_output/processinfo/37411020-4142-4b08-b825-343ba2427bf7.json

@@ -1 +0,0 @@
-{"parent":null,"pid":74271,"argv":["/Users/jaredwray/.nvm/versions/node/v16.13.1/bin/node","/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/node_modules/.bin/ava","--serial"],"execArgv":[],"cwd":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv","time":1641659048071,"ppid":74270,"coverageFilename":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/.nyc_output/37411020-4142-4b08-b825-343ba2427bf7.json","externalId":"","uuid":"37411020-4142-4b08-b825-343ba2427bf7","files":[]}

package/.nyc_output/processinfo/cd79f2de-c8b8-4493-bc15-b2bde28efa4b.json

@@ -1 +0,0 @@
-{"parent":"37411020-4142-4b08-b825-343ba2427bf7","pid":74274,"argv":["/Users/jaredwray/.nvm/versions/node/v16.13.1/bin/node","/Users/jaredwray/src/github.com/jaredwray/keyv/node_modules/ava/lib/worker/subprocess.js"],"execArgv":[],"cwd":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv","time":1641659048289,"ppid":74271,"coverageFilename":"/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/.nyc_output/cd79f2de-c8b8-4493-bc15-b2bde28efa4b.json","externalId":"","uuid":"cd79f2de-c8b8-4493-bc15-b2bde28efa4b","files":["/Users/jaredwray/src/github.com/jaredwray/keyv/packages/keyv/src/index.js"]}