Документация

$ npm i -g @tessera/cli
$ tessera login
$ tessera init my-api --template minimal
$ cd my-api && tessera deploy --prod

my-api/
  src/index.js      # точка входа, экспортирует handler
  tessera.json      # конфигурация: маршруты, cron, биндинги
  .env.preview      # переменные для превью-окружения
  .tessera/         # кеш сборки, в git не нужен

# разработка
$ tessera dev --port 8787 --kv-persist
# деплой
$ tessera deploy            # в превью-окружение
$ tessera deploy --prod     # в продакшен, во все точки
# наблюдение
$ tessera logs --tail --pop dme1
$ tessera trace --last 20 --min-ms 40
# секреты
$ tessera secret put STRIPE_KEY --env prod
$ tessera secret ls
# версии
$ tessera versions
$ tessera rollback v41

{
  "name": "my-api",
  "main": "src/index.js",
  "compatibility": "2026-06-01",
  "routes": [
    { "pattern": "api.example.ru/*", "zone": "example.ru" }
  ],
  "kv": [{ "binding": "CACHE", "namespace": "prod-cache" }],
  "cron": [{ "expr": "*/5 * * * *", "handler": "scheduled" }],
  "limits": { "cpu_ms": 50 }
}

ctx.waitUntil(env.CACHE.put(key, body, { ttl: 300 }));

const routes = [
  { m: "GET",  p: new URLPattern({ pathname: "/users/:id" }), h: getUser },
  { m: "POST", p: new URLPattern({ pathname: "/users" }),     h: createUser }
];

export async function handler(request, env, ctx) {
  for (const r of routes) {
    if (r.m !== request.method) continue;
    const match = r.p.exec(request.url);
    if (match) return r.h(request, env, match.pathname.groups);
  }
  return Response.json({ error: "not_found" }, { status: 404 });
}

{
  "pop": "dme1",
  "city": "Москва",
  "country": "RU",
  "region": "MOW",
  "latitude": 55.75,
  "longitude": 37.62,
  "asn": 12389
}

export async function handler(request, env, ctx) {
  const { readable, writable } = new TransformStream();
  const writer = writable.getWriter();
  const enc = new TextEncoder();

  ctx.waitUntil((async () => {
    for (let i = 1; i <= 5; i++) {
      await writer.write(enc.encode(`data: тик ${i}\n\n`));
      await new Promise(r => setTimeout(r, 1000));
    }
    await writer.close();
  })());

  return new Response(readable, {
    headers: {
      "content-type": "text/event-stream",
      "cache-control": "no-cache",
      "x-accel-buffering": "no"
    }
  });
}

$ tessera secret put STRIPE_KEY --env prod
? Значение: ********************
✔ Записано. Значение больше не покажется.
$ tessera secret ls --env prod
STRIPE_KEY   обновлён 2 дня назад
JWT_SECRET   обновлён 14 дней назад

// чтение
const raw = await env.CACHE.get("user:42");            // строка или null
const obj = await env.CACHE.get("user:42", "json");    // сразу разобранный JSON

// запись с временем жизни
await env.CACHE.put("user:42", JSON.stringify(user), { ttl: 3600 });

// перебор по префиксу
const { keys, cursor } = await env.CACHE.list({ prefix: "user:", limit: 100 });

// удаление
await env.CACHE.delete("user:42");

export async function scheduled(event, env, ctx) {
  // event.cron — выражение, event.scheduledTime — плановое время
  const stale = await env.CACHE.list({ prefix: "session:" });
  for (const key of stale.keys) {
    if (key.expiresAt < Date.now()) await env.CACHE.delete(key.name);
  }
  console.log("подчищено ключей:", stale.keys.length);
}

$ tessera dev --cron "*/5 * * * *"
$ tessera trigger scheduled            # ручной запуск

$ tessera logs --tail --pop dme1 --level warn
14:22:07.412  dme1  warn   KV miss для quote:RU        req_8f21ac
14:22:07.598  dme1  info   ответ 200, cpu 4.1 мс       req_8f21ac
14:22:09.004  fra1  error  апстрим 503, повтор 1/3     req_9b02de

{
  "observability": {
    "otlp": { "endpoint": "https://otel.example.ru:4318", "sample": 0.1 },
    "logs": { "retention_days": 7 }
  }
}