Key-Value Store (KV) feature introduced in the NATS messaging system. The Key-Value Store in NATS provides a distributed storage system where data can be stored and accessed using a simple key-value interface. It is built on top of the core NATS messaging infrastructure, which means it inherits the same principles of speed, scalability, and reliability that NATS is known for. Read more here .
This can now serve as a datasource for WunderGraph.
serverURL(string, optional): The endpoint for your NATS server. Defaults to nats://localhost:4222 for the embedded test server.
token(string, optional): The authorization token for your NATS server.
apiNamespace(string): The namespace to be used for the datasource
model(Zod schema): The model is defined using Zod, a TypeScript-first schema declaration library. It describes the shape of the data to be stored in the NATS KV.
history(number): The history parameter specifies the number of past revisions of the kv store that can be accessed.
How it works
introspect.natsKVtakes the provided Zod model and creates a GraphQL schema based on it, so the NATS KV service can interact with the data in a standardized way.
The generated GraphQL schema allows clients to perform all supported operations here .
We will go over 4 of the available 11 operations that can be performed over the key value store.
First we introspect the key value store and add it to the list of apis
Next define a graphql operation that creates an entry into the key value store
Execute the above operation using the CURL below. If the creation is successful you should get back all the details for the key.
Now let's write a mutation to update the key. It takes a the key, value and revision number that we received from the previous request.
Let us execute it. You should receive a response with the updated value and the new revision number.
Now that we have updated the key, we can view the revision history.
Execute the below CURL request. You should receive a list of revisions.
Finally we can delete the key from the store.
Let us execute it. You should receive a response
Local Development and Testing
By default WunderGraph runs a test server of NATS for development purposes with the endpoint nats://localhost:4222. It is recommended to disable this in production using
WG_DISABLE_EMBEDDED_NATS=true. This is automatically set and disabled on WunderGraph Cloud.