Runtime SDK

@korve-dev/sdk is server-only. Korve injects a project-and-environment-scoped runtime token and delivery secret; never substitute an organization API key or bundle the SDK into browser code.

@korve-dev/sdk is release-ready in the repository but is not yet available from the public npm registry. Do not add it as an npm dependency until anonymous registry installation succeeds. The examples currently use the checked-out workspace package.

import { ack, createKorve, retry } from "@korve-dev/sdk";

const korve = createKorve();
const emails = korve.queue<{ userId: string }>("emails");
const media = korve.storage("media");
await emails.send({ userId: "u_123" }, { idempotencyKey: "welcome:u_123" });

const upload = await media.createUpload({
  filename: "avatar.png",
  contentType: "image/png",
  byteLength: bytes.byteLength,
});
await fetch(upload.url, {
  method: upload.method,
  headers: upload.headers,
  body: bytes,
});

export const POST = korve.handler<{ userId: string }>(async (message) => {
  await persistWelcomeEmailOnce(message.id, message.body.userId);
  return ack(); // or retry(30)
});

Queue delivery is at least once. Make durable effects idempotent with message.id; the SDK verifies the timestamp and signature, but your application owns business-level deduplication. sendBatch accepts up to 100 messages in one atomic request. korve.cache("sessions") returns the injected TLS connection string for a ready cache. The same client exposes:

Surface	Runtime authority
`storage(bucket?)`	Mint short-lived upload/download grants; no list or delete
`realtime(name)`	Publish events and mint short-lived channel capabilities
`ai(name)`	Call allowlisted model aliases through the gateway budget
`payments`	Create end-customers and hosted checkout sessions

The runtime token fixes project and environment server-side; method arguments cannot override that scope. Signed URLs, cache connection strings, and realtime capabilities are secrets. Never persist or log them. See Queues, Storage, Realtime, AI Gateway, Customer payments, and Caches.

Start

Core concepts

Agents

Build

Data and work

Operate

CLI reference

API reference