strava-cz-api

Neoficiální TypeScript SDK pro strava.cz — systém pro objednávání obědů ve školních jídelnách.

⚠️ Upozornění: Prostředí strava.cz se liší jídelna od jídelny (různý počet jídel, názvy chodů apod.). Některé metody mohou vyžadovat drobné úpravy pro konkrétní jídelnu.

Proč tato knihovna?

Oproti původní Python verzi přináší TypeScript přepis:

• Nulové závislosti — používá nativní fetch (Node 18+), žádný axios ani got
• Plné typy — kompletní TypeScript definice pro všechny odpovědi API
• Edge runtime — funguje v Next.js Edge, Cloudflare Workers, Bun i Deno
• Dual package — ESM i CommonJS z jednoho balíčku
• React hooks — useJidelnicekToday, useJidelnicekAll, usePostJidlo pro Next.js a React
• CLI — npx strava menu, npx strava objednat <jídlo> přímo z terminálu
• Session management — ApiSession s automatickým re-loginem při expiraci SID
• Cookie persistence — FileSessionStore ukládá session na disk, není třeba logovat při každém spuštění
• Timeout — každý požadavek má výchozí timeout 10 s, konfigurovatelný přes ApiOptions
• Debug logging — STRAVA_DEBUG=1 vypíše všechny požadavky do stderr

Instalace

npm install strava-cz-api

Vyžaduje Node.js 18+.

Přihlášení

import { Auth } from 'strava-cz-api'

const { cookie, sid, s5url } = await Auth.login('uzivatel', 'heslo', '0000')

Parametry:

• username — uživatelské jméno
• password — heslo
• cisloJidelny — číslo jídelny
• lang — jazyk: 'CZ' (výchozí) | 'EN' | 'SK'
• zustatPrihlasen — zůstat přihlášen: true (výchozí)

Autentizované API

import { Api } from 'strava-cz-api'

const api = new Api({ sid, s5url, cisloJidelny: '0000', cookie })

Volitelné parametry konstruktoru:

• cookie — session cookie (výchozí se doplní automaticky)
• lang — jazyk: 'CZ' (výchozí) | 'EN' | 'SK'
• timeoutMs — timeout požadavku v ms (výchozí: 10000)
• debug — podrobné logování (alternativně STRAVA_DEBUG=1)

Jídelníček

// Dnešní jídelníček
const dnes = await api.getJidelnicekToday()  // JidelnicekItem[]

// Celý jídelníček
const vse = await api.getJidelnicekAll()     // Record<string, JidelnicekItem[]>

Objednávání

// Přihlásit jídlo (veta = ID políčka z getJidelnicek)
await api.postJidlo('172', 1)   // 1 = přihlásit, 0 = odhlásit

// Pomocník — najde veta ID podle názvu jídla
const veta = await api.getVetaByNazev('svíčková')
if (veta) await api.postJidlo(veta, 1)

// Přihlásit/odhlásit celý den
await api.postDen('2026-06-30', 1)

// Uložit změny — VŽDY zavolat po postJidlo / postDen
await api.postOrders()

// Zrušit neuložené změny
await api.resetChanges()

Informace o uživateli

const username = await api.getUsername()   // string
const info     = await api.getInfo()       // UserInfo

Ostatní metody

| Metoda | Vrací | Popis | |--------|-------|-------| | getJidelnicekToday() | JidelnicekItem[] | Dnešní jídelníček | | getJidelnicekAll() | Record<string, JidelnicekItem[]> | Celý jídelníček | | getInfo() | UserInfo | Informace o uživateli | | getUsername() | string | Uživatelské jméno | | getJidelna() | JidelnaInfo | Informace o jídelně | | getVetaByNazev(nazev, datum?) | string \| null | Najde veta ID podle názvu jídla | | getHistorieKlienta(date) | HistorieKlientaItem[] | Historie objednávek za měsíc (date = první den, např. '2026-01-01') | | getPlaby() | PlatbaItem[] | Pohyby na účtu | | getMessages() | MessagesResponse | Zprávy pro uživatele | | getProtokol() | ProtakolItem[] | Protokol | | getVydej() | VydejItem[] | Vydaná jídla | | postJidlo(veta, stav) | void | Přihlásit (1) nebo odhlásit (0) jídlo | | postDen(datum, stav) | void | Přihlásit (1) nebo odhlásit (0) celý den | | postOrders() | void | Uložit neuložené změny objednávek | | resetChanges() | void | Zrušit neuložené změny |

ApiSession — automatický re-login

ApiSession se sám znovu přihlásí, pokud SID expiruje. Není třeba hlídat session ručně.

import { ApiSession } from 'strava-cz-api'

const session = new ApiSession('uzivatel', 'heslo', '0000')

// Při prvním volání se automaticky přihlásí
const menu = await session.getJidelnicekToday()

// Pokud SID expiruje, automaticky re-loginuje a zopakuje požadavek
const info = await session.getInfo()

Volitelné možnosti:

const session = new ApiSession('uzivatel', 'heslo', '0000', {
  lang: 'CZ',
  timeoutMs: 15000,
  onRelogin: () => console.log('Session obnovena'),
})

ApiSession podporuje stejné metody jako Api.

Cookie persistence

Uloží session na disk — při dalším spuštění není třeba znovu logovat.

import { ApiSession, FileSessionStore } from 'strava-cz-api'
import { Auth } from 'strava-cz-api'

const store = new FileSessionStore()  // výchozí: ~/.strava-session.json

// Načti uloženou session, nebo se přihlas a ulož novou
let session = await store.load()
if (!session) {
  const result = await Auth.login('uzivatel', 'heslo', '0000')
  await store.save(result)
  session = result
}

const api = new Api({ ...session, cisloJidelny: '0000' })

Session expiruje automaticky po 20 hodinách.

Veřejné endpointy (bez přihlášení)

import { Public } from 'strava-cz-api'

// Seznam všech jídelen
const jidelny = await Public.getJidelny()

// Informace o konkrétní jídelně
const jidelna = await Public.getJidelna('0000')

// Veřejný jídelníček
const menu = await Public.getJidelnicek('0000', 'CZ')

Filtr

import { Filter } from 'strava-cz-api'

const menu = await api.getJidelnicekAll()

// Vrátí jen pole nazev, cena a pocet
const filtrovano = Filter.filterJson(['nazev', 'cena', 'pocet'], menu)

React / Next.js hooks

npm install strava-cz-api react

import { useJidelnicekToday, usePostJidlo } from 'strava-cz-api/react'

const credentials = { username: 'demo1', password: 'demo1', cisloJidelny: '0000' }

export default function Menu() {
  const { data, loading, error, refetch } = useJidelnicekToday(credentials)

  if (loading) return <p>Načítám...</p>
  if (error)   return <p>Chyba: {error.message}</p>

  return (
    <ul>
      {data?.map(item => (
        <li key={item.veta}>
          {item.druhPopis}: {item.nazev} — {item.cena} Kč
          {item.pocet > 0 && ' ✓'}
        </li>
      ))}
    </ul>
  )
}

Dostupné hooks:

| Hook | Popis | |------|-------| | useJidelnicekToday(config) | Dnešní jídelníček, vrací { data, loading, error, refetch } | | useJidelnicekAll(config) | Celý jídelníček, vrací { data, loading, error, refetch } | | usePostJidlo(config) | Přihlásit/odhlásit jídlo, vrací { mutate, loading, error } |

CLI

# Přihlášení (uloží session do ~/.strava-session.json)
npx strava login

# Dnešní jídelníček
npx strava menu

# Celý jídelníček
npx strava menu --all

# Objednat jídlo (hledá podle názvu)
npx strava objednat svíčková

# Odhlásit jídlo
npx strava odhlasit řízek

# Informace o účtu
npx strava info

# Odhlásit se
npx strava logout

Debug logging

STRAVA_DEBUG=1 node muj-script.js

Výstup do stderr:

[strava-cz-api] POST https://app.strava.cz/api/login → 200 (312ms)
[strava-cz-api] GET https://app.strava.cz/api/objednavky → 200 (89ms)

Chyby

import { StravaError, ChybneHesloError, JidelnaNenalezenaError } from 'strava-cz-api'

try {
  await Auth.login('uzivatel', 'spatne_heslo', '0000')
} catch (err) {
  if (err instanceof ChybneHesloError) {
    console.log('Chybné heslo')
  } else if (err instanceof StravaError) {
    console.log('Chyba API:', err.message)
  }
}

| Třída | Kód | Příčina | |-------|-----|---------| | JidelnaNenalezenaError | 6 | Jídelna nebyla nalezena | | ChybneSIDError | 15 | Neplatný nebo expirovaný SID | | ChybneHesloError | 13405 | Chybné heslo | | BackendError | 3002 | Chyba backendu jídelny | | UcetZablokovanError | 13406 | Účet zablokován | | NedostatecnyZustatekError | 1001 | Nedostatek kreditu na účtu | | ObjednavkaUzavrenaError | 5001 | Objednávka je uzavřena | | TerminPropadlError | 5002 | Termín pro objednání propadl | | RequestTimeoutError | — | Požadavek překročil timeout |

Typy

JidelnicekItem

interface JidelnicekItem {
  id: number
  datum: string           // "30.06.2026"
  druhPopis: string       // "Polévka"
  druhChod: string        // "Oběd"
  nazev: string
  popis: string
  alergeny: string[]
  alergenyText: string
  chod: string            // "C"
  druh: string            // "OB"
  cena: string            // "45.00"
  polevka: string         // "N" / "A"
  pocet: number           // 1 = přihlášeno, 0 = odhlášeno
  veta: string            // ID políčka pro postJidlo()
  casKonec: string        // do kdy lze přihlásit (ISO datetime)
  casOdhlaseni: string
  obrazky: string[]
  // ...další pole
}

UserInfo

interface UserInfo {
  id: string          // uživatelské jméno
  jmeno: string
  email: string
  konto: string       // zůstatek, např. "-50"
  mena: string        // "Kč"
  nazevJidelny: string
  cislo: string       // číslo jídelny
  // ...další pole
}

VydejItem

interface VydejItem {
  datum: string   // "DD.MM.YYYY"
  cas: string     // "HH:MM"
  vydano: number  // 0 = nevydáno, 1 = vydáno
  nazev: string
  druh: string    // "oběd 1"
  pocet: string
}

Demo účet

Demo účet lze vytvořit na https://www.strava.cz/strava/Stravnik/Demo
Přihlášení: jméno demo1, heslo demo1, číslo jídelny 0000

const { sid, s5url, cookie } = await Auth.login('demo1', 'demo1', '0000')