Skip to content

@onlyworlds/sdk 4.6.0

Choose a tag to compare

@tmoosting tmoosting released this 20 Oct 14:24
· 95 commits to main since this release

Published from e198298 (tag v4.6.0); the tarball was checked against a build of that commit.

Includes 4.5.1's documentation fixes: 4.5.1 was staged and never published.

Added

  • uploadImage(image, { key?, ticket? }): upload one image (webp, png, jpeg, avif;
    never SVG; 4.6.0's docs also said gif, which the edge refuses with 415) and get its permanent public URL. Two requests: a ticket from keel
    (POST /media/ticket), then the bytes straight to the edge at the ticket's upload_url
    (keel never sees them). Only the ticket goes to the edge, never the API key or PIN. An image
    larger than the ticket's max_bytes throws 413 too_large before anything is sent; the edge's
    refusals (ticket_used, ticket_expired, bad_key, exists, unsupported_type, ...) arrive
    as OwApiError with their code. Set the returned url as an element's image_url yourself.
    Checked live on 2026-10-06: one upload through keel's ticket to the edge (201), and the same
    ticket again refused with 401 ticket_used.
  • createMediaTicket(): the first step alone, for callers that upload themselves (progress
    bars, say). Types OwMediaTicket and OwUploadedImage.

Documented

  • ListParams.filter lists what keel accepts now: exact name, and characters=<id> on every
    type with a characters link (keel D76d).