KV Store

import { getKv } from '@sylphx/sdk/server'

const kv = getKv()

// SET — store any JSON-serializable value
await kv.set('user:123', { name: 'John', score: 100 })

// SET with TTL — expires in 1 hour (3600 seconds)
await kv.set('session:abc', { userId: '123' }, { ex: 3600 })

// SET with millisecond precision TTL
await kv.set('lock:resource', true, { px: 5000 }) // 5 seconds

// SET with Unix timestamp expiration
await kv.set('promo:summer', { discount: 20 }, {
  exat: Math.floor(Date.now() / 1000) + 86400 // expires in 24h
})

// SET if Not eXists — only set if key is new
await kv.set('user:123:email', 'john@example.com', { nx: true })

// SET if eXists — only update existing keys
await kv.set('user:123:email', 'new@example.com', { xx: true })

// GET — returns value and remaining TTL
const { value, ttl } = await kv.get('user:123')
// value: { name: 'John', score: 100 }, ttl: null (no expiry)

// DELETE — returns number of keys removed (0 or 1)
const deleted = await kv.del('session:abc')

// EXISTS — check if a key exists
const exists = await kv.exists('user:123') // true

// EXPIRE — set or update TTL on existing key
await kv.expire('user:123', 7200) // expire in 2 hours

import { getKv } from '@sylphx/sdk/server'

const kv = getKv()

// Basic API rate limiting — 100 requests per hour
const { success, remaining, limit, reset } = await kv.ratelimit(
  'api:user:123',
  { limit: 100, window: '1h' }
)

if (!success) {
  return new Response('Too Many Requests', {
    status: 429,
    headers: {
      'X-RateLimit-Limit': String(limit),
      'X-RateLimit-Remaining': String(remaining),
      'X-RateLimit-Reset': String(reset),
      'Retry-After': String(Math.ceil((reset - Date.now()) / 1000)),
    },
  })
}

// Different limits per tier
const limits = {
  free: { limit: 100, window: '1h' },
  pro: { limit: 1000, window: '1h' },
  enterprise: { limit: 10000, window: '1h' },
}

const result = await kv.ratelimit(
  `api:${userId}`,
  limits[userPlan]
)

// Login attempt limiting — 5 attempts per 15 minutes
const loginResult = await kv.ratelimit(
  `login:${email}`,
  { limit: 5, window: '15m' }
)

// Short burst limiting — 10 requests per 10 seconds
const burstResult = await kv.ratelimit(
  `burst:${ip}`,
  { limit: 10, window: '10s' }
)

import { getKv } from '@sylphx/sdk/server'

const kv = getKv()

// MSET — set multiple keys atomically
await kv.mset([
  { key: 'config:theme', value: 'dark' },
  { key: 'config:locale', value: 'en-US' },
  { key: 'config:timezone', value: 'America/New_York' },
])

// MSET with shared TTL
await kv.mset(
  [
    { key: 'cache:user:1', value: { name: 'Alice' } },
    { key: 'cache:user:2', value: { name: 'Bob' } },
  ],
  { ex: 300 } // all expire in 5 minutes
)

// MGET — get multiple keys in one round trip
const values = await kv.mget(['config:theme', 'config:locale', 'config:timezone'])
// { 'config:theme': 'dark', 'config:locale': 'en-US', 'config:timezone': 'America/New_York' }

// Missing keys return null
const mixed = await kv.mget(['exists:key', 'missing:key'])
// { 'exists:key': 'value', 'missing:key': null }