Skip to content

5.7.0

API

API v5.7.0 — npm package & instance configuration.

  • The @20syldev/api package now imports directly: import { evaluate } from '@20syldev/api' targets the latest version, @20syldev/api/server starts the full API with every version mounted, and TypeScript declarations ship with it. The /v1 and /v2 subpaths pointed at non-existent files — fixed.
  • GET /url returns the scheme's default port when the URL omits it: 443 for https and wss, 80 for http and ws, 21 for ftp. null is now reserved for schemes with no known default.
  • Instance metadata becomes configurable — DOCS_URL, REPO_URL, INSTANCE_CREATED — and each field disappears from GET /infos until it is set, so a self-hosted instance no longer advertises someone else's documentation or repository.
  • /logs can be gated behind a token, expected in the X-Logs-Token header and defined by LOGS_TOKEN. Without that variable it stays open, as before.
  • Request logs no longer keep parameter values: ?text=secret is recorded as ?text. Private chat and game tokens carried in the path are masked too.
  • TRUSTED_PROXIES describes the trusted hops behind a CDN or platform router, as CIDR blocks or via the loopback, linklocal and uniquelocal shorthands.
  • Error responses no longer carry the documentation link they used to include — the body is now message, error and status only.
  • Node 22.12 becomes the minimum, which allows the package to be used in both ESM and CommonJS.

Documentation

  • Removed the documentation field from every error example on the Getting Started page, matching the lighter error body.
  • Documented the per-scheme default ports on URL and corrected the port field, which no longer returns null whenever the URL omits it.
  • Marked the documentation, github and creation fields on Infos as instance-dependent, since a self-hosted instance omits them unless configured.