velven
Docs
Menu

Changelog

What each release of @velven/sdk and the script tag added. Releases only add: nothing a page already calls changes or goes away. Versions explains which release a page runs.

View guide as Markdown

0.3.0

History reads, retry keys, cancelling a sign-in and a server helper.

  • top, around and mine take bucket (current, previous or a date) and season, to read past days, weeks and seasons.
  • Every read carries info: the board's label, unit, metric, sort, mode, entries, period, bucket and season.
  • top({ after }) pages in the bucket and season the row was read from, so a board paged across midnight stays on its day.
  • scores.submit takes requestId, so a retried run is entered once.
  • signIn takes an AbortSignal as signal, and a cancelled ask answers cancelled.
  • Velven.version names the release, and Velven.space the space the page runs in.
  • createVelven({ probeTimeoutMs }) and data-probe-timeout on the script tag set how long a frame waits for Velven, 3 to 60 seconds.
  • A signed_out answer to a score call clears the cached token and Velven.user.
  • Locally, boards roll over by period and season, and 3 new query parameters arrive: ?velven_seed=, ?velven_strict=1 and ?velven_slow=.
  • @velven/sdk/server adds verifyToken and postScore, for Node 20 and later, Deno, Bun and Cloudflare Workers.

0.2.0

Saves, and the player's own row.

  • Velven.data keeps a player's progress with getItem, setItem, removeItem and clear, up to 1 MB per player and space.
  • scores.mine({ board }) answers the player's own row, or null before their first score.

0.1.0

The first release, as the script tag and the npm package @velven/sdk.

  • ready(), Velven.environment and Velven.user.
  • signIn(), plain or { silent: true }, and onAuth.
  • scores.submit, scores.top and scores.around.
  • The local environment, with ?velven_user=, ?velven_token=expired and ?velven_local=1.