@radzor/kv-store

Key-value store with TTL support. Operates in-memory by default with optional Redis backend via raw RESP protocol. Supports expiration callbacks and namespace isolation.

Storagev0.1.0typescriptpythonServerkvkey-valuestoreredisttlcachememoryby Radzor

Install

View source on GitHub →

$npx radzor@latest add kv-store

⚠ Constraints: In-memory mode requires no dependencies and is lost on process restart. Redis mode uses raw RESP protocol over TCP (no npm packages). TTL is in milliseconds. Namespace prefixes are applied transparently — keys() returns unprefixed keys.

Inputs

Name	Type	Default	Description
mode	"memory" \| "redis"	memory	Storage backend (default: memory).
redisUrl	string	—	Redis connection URL (required when mode is 'redis').REDIS_URL
namespace	string	—	Key prefix for namespace isolation (default: none).
defaultTtl	number	0	Default TTL in milliseconds (0 = no expiry, default: 0).

mode"memory" | "redis"

Storage backend (default: memory).

default: memory

redisUrlstring

{ "llm": { "constraints": "In-memory mode requires no dependencies and is lost on process restart. Redis mode uses raw RESP protocol over TCP (no npm packages). TTL is in milliseconds. Namespace prefixes are applied transparently — keys() returns unprefixed keys.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/kv-store", "tags": [ "kv", "key-value", "store", "redis", "ttl", "cache", "memory" ], "events": [ { "name": "onExpired", "payload": { "key": "string", "value": "string" }, "description": "Fired when a key expires (in-memory mode only, checked on access or sweep)." } ], "inputs": [ { "name": "mode", "type": "\"memory\" | \"redis\"", "default": "memory", "required": false, "description": "Storage backend (default: memory)." }, { "name": "redisUrl", "type": "string", "envVar": "REDIS_URL", "required": false, "description": "Redis connection URL (required when mode is 'redis')." }, { "name": "namespace", "type": "string", "required": false, "description": "Key prefix for namespace isolation (default: none)." }, { "name": "defaultTtl", "type": "number", "default": 0, "required": false, "description": "Default TTL in milliseconds (0 = no expiry, default: 0)." } ], "radzor": "1.0.0", "actions": [ { "name": "get", "params": [ { "name": "key", "type": "string", "description": "Key to retrieve." } ], "returns": "Promise<string | null>", "description": "Get a value by key. Returns null if not found or expired." }, { "name": "set", "params": [ { "name": "key", "type": "string", "description": "Key to set." }, { "name": "value", "type": "string", "description": "Value to store." }, { "name": "ttl", "type": "number", "required": false, "description": "TTL in milliseconds. Overrides defaultTtl." } ], "returns": "Promise<void>", "description": "Set a key-value pair with optional TTL." }, { "name": "delete", "params": [ { "name": "key", "type": "string", "description": "Key to delete." } ], "returns": "Promise<boolean>", "description": "Delete a key. Returns true if it existed." }, { "name": "has", "params": [ { "name": "key", "type": "string", "description": "Key to check." } ], "returns": "Promise<boolean>", "description": "Check if a key exists and is not expired." }, { "name": "keys", "params": [ { "name": "pattern", "type": "string", "required": false, "description": "Glob pattern to filter keys (default: *)." } ], "returns": "Promise<string[]>", "description": "List all keys matching a pattern." }, { "name": "clear", "params": [], "returns": "Promise<void>", "description": "Delete all keys in the current namespace." } ], "outputs": [ { "name": "storeStats", "type": "{ size: number; mode: string; namespace: string }", "fields": [ { "name": "size", "type": "number", "description": "Number of keys in the store." }, { "name": "mode", "type": "string", "description": "Active storage mode." }, { "name": "namespace", "type": "string", "description": "Current namespace prefix." } ], "description": "Current store statistics." } ], "runtime": "server", "version": "0.1.0", "category": "storage", "languages": [ "typescript", "python" ], "description": "Key-value store with TTL support. Operates in-memory by default with optional Redis backend via raw RESP protocol. Supports expiration callbacks and namespace isolation.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onExpired", "description": "Log key expirations for debugging", "compatibleWith": [ "@radzor/log-aggregator.action.info.message", "@radzor/event-tracker.action.track.eventName" ] } ] } }

@radzor/kv-store

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json