npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@digitalwerber/payload-kv-cloudflare

v0.1.0

Published

Payload KV adapter for Cloudflare Workers KV

Readme

@digitalwerber/payload-kv-cloudflare

A Payload KV adapter backed by Cloudflare Workers KV. Use it as kv in your Payload config, then read and write through payload.kv.

Install

pnpm add @digitalwerber/payload-kv-cloudflare

Usage

Pass the KV namespace binding of your Worker:

import { cloudflareKVAdapter } from '@digitalwerber/payload-kv-cloudflare'
import { buildConfig } from 'payload'

export default buildConfig({
  // ...
  kv: cloudflareKVAdapter({
    namespace: env.KV,
    ttl: { 'cache:': 30 * 24 * 3600 },
  }),
})
await payload.kv.set('cache:posts', posts) // expires after 30 days
await payload.kv.get('cache:posts')

Options

| Option | Default | Description | | ----------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | namespace | required | The Workers KV binding (KVNamespace). | | ttl | {} | Expiration in seconds per key prefix. The longest matching prefix wins; keys without a match never expire. Values under 60 are raised to 60. | | keyPrefix | 'payload-kv:' | Prefix for the stored keys. keys() and clear() only see keys with this prefix, so the namespace can hold other data. |

Supported Payload versions

Payload 3.62 and later, Payload 4 (beta).

Limits

Handled by the adapter

  • Keys over 512 bytes are stored under a shortened key: its start, including the prefix, followed by a hash of the full key. ttl still applies and keys() returns the full key. Keys of about 1000 bytes and more are rejected, because the full key has to fit into the 1024 bytes of KV metadata.
  • Expiration is at least 60 seconds.
  • keys() and clear() page through the whole list.

Not handled by the adapter

For the current numbers, see Cloudflare's KV limits.

  • Eventual consistency. A write reaches other locations with a delay. Don't use the store for values several requests must agree on at once, such as counters or locks.
  • Writes to the same key are rate limited; more frequent writes may fail.
  • KV operations per Worker invocation are limited. clear() deletes key by key, so on a larger store it can fail part way; call it again in a new invocation until keys() is empty.
  • Values are stored as JSON and count against the KV value size limit.

License

MIT