Lexicon Garden

pet.trezy.setPreferences

Save a text style, either for the whole account or for one device. ⚠ `scope` IS REQUIRED AND HAS NO DEFAULT. Guessing it is the one mistake that cannot be undone by guessing again: silently defaulting to `account` changes the typeface on every device somebody owns when they meant to change one, and silently defaulting to `device` leaves them wondering why their laptop never followed. The client always knows which the player asked for, because the player was asked.

Repository @trezy.pet did:plc:ollch4g7tes2reb5eceiwuol namespace authority
Details · procedure
Kindprocedure
Authoritytrezy.pet
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

deviceId

string

Required for `device` scope; optional for `account`, where supplying it clears this device's override. Opaque — the client generates it and it must carry nothing about the device or the person.

  • maxLength: 64

featureOffered

boolean

Account-scope only.

fingerprint

string
  • maxLength: 64

label

string
  • maxLength: 60

scope

requiredstring

`account` writes the account-wide default AND deletes this device's override, so the device the player is holding actually follows the choice they just made. `device` writes an override for `deviceId` alone and leaves the account default untouched.

  • knownValues: account | device

typeMode

string
  • knownValues: pixel | softer | system

typeOffered

boolean

Account-scope only. Refused with `device`, because being told about pixel type is a fact about a person and storing it per-device would re-arm the notice on every new device.

Output

application/json

error

string

A stable machine code the client branches on — add codes, never rename them.

  • knownValues: not-authenticated | invalid-scope | invalid-mode | device-required | offered-is-account-scope | nothing-to-do | save-failed

featureOffered

boolean

Account-scope only.

message

string

typeMode

string
  • knownValues: pixel | softer | system

typeOffered

boolean

updatedAt

string · datetime

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • pet.trezy.getPreferences

    query

    Everything the caller's account knows about how to present the game: the account-wide default, and every device that has been given its own text style. Takes no DID — it answers for whoever is authenticated and nobody else. ⚠ IT RETURNS THE WHOLE PICTURE RATHER THAN AN ANSWER, deliberately: which of these applies depends on which device is asking and what its browser still remembers, and that reconciliation lives in one tested place on the client (src/lib/preferences.ts) instead of being half he

  • pet.trezy.preferences

    record