kikobeats/cloudflare-workers-kv

Node.js library to interact with CloudFlare Workers KV.

@kikobeats/cloudflare-workers-kv

Node.js library to interact with CloudFlare Workers KV.

Deprecation note: this library uses CloudFlare REST API that is slow. You should to use runtime API to interact the most optimal way.

CloudFlare Workers KV is faster <key, value> storage that runs on top of CloudFlare Network to offer a geo-distributed service almost free or reasonable cheaper.

Use it in combination with CloudFlare Workers or AWS Lambda to have a truly serverless database access, where the value will be serve from the nearest edge node, being the lowest response latency possible.

Install

$ npm install @kikobeats/cloudflare-workers-kv --save

Usage

The library is a convenient way to interact with CloudFlare Workers KV via usinng CloudFlare Workers KV API.

const cloudFlareWorkersKV = require('@kikobeats/cloudflare-workers-kv')
const ms = require('ms')

const store = cloudFlareWorkersKV({
  accountId: '<Cloudflare-Account-Id>',
  key: '<Cloudflare-API-Key>',
  namespaceId: '<Cloudflare-Workers-KV-Namespace-Id>'
})

async function examples () {
  // get a value
  await store.get('foo')

  // set a value forever
  await store.set('foo', 'bar')

  // set a value associating with a time-to-live associated
  await store.set('foo', 'bar', ms('5m'))

  // delete a value
  await store.delete('foo')
}

Authentication

At CloudFlare dashboard, enter to Your Profile > API Token > Create Token.

Then use CloudFlare Workers template and ensure at least the permission Workers KV Storage is present.

The API token provided should be provided as key.

License

@kikobeats/cloudflare-workers-kv © Kiko Beats, released under the MIT License.
Authored and maintained by Kiko Beats with help from contributors.

kikobeats.com · GitHub Kiko Beats · Twitter @Kikobeats

cloudflare-workers-kv's Issues

Why are you making the assumption that value payloads should be JSON.stringified?

Why are you making the assumption that value payloads should be JSON.stringified? I wanted to store a string in there and now it adds commas around that value. This seems like something the user should do.